• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Nova
  5. Metadata
  6. Delete Metadata Item

Delete Metadata Item

Function Description

This interface is used to delete the metadata of a specified key.

Interface Format

Method

URI

Description

DELETE

/v2/{tenant_id}/servers/{server_id}/metadata/{key}

/v2.1/{tenant_id}/servers/{server_id}/metadata/{key}

Deletes the metadata of a specified key.

Restrictions

The ECS must be in the active, stopped, paused, or suspended state. That is, the value of the OS-EXT-STS:vm_state attribute of the ECS must be active, stopped, paused, or suspended.

Expanded Interface

N/A

Request Parameter

N/A

Response Parameter

N/A

Request Example

DELETE /v2/9c53a566cb3443ab910cf0daebca90c4/servers/998af54b-5762-4041-abc1-f98a2c27b3a2/metadata/key1

DELETE /v2.1/9c53a566cb3443ab910cf0daebca90c4/servers/998af54b-5762-4041-abc1-f98a2c27b3a2/metadata/key1

Response Example

N/A

Returned Values

For details, see section General Request Returned Values.

Error Code

Table 1 Task error code

Error Code

Description

404

Server does not exist.

This error occurs if the ECS does not exist.