|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| MDATA-DELETE(1) | Metadata Commands | MDATA-DELETE(1) |
NAME
mdata-delete -- Delete a metadata key-value pair.SYNOPSIS
/usr/sbin/mdata-delete keyname
DESCRIPTION
The mdata-delete command allows the user (or a script) to modify the metadata for a guest instance running in a SmartDataCenter (SDC) cloud. Metadata values are generally set programmatically via CloudAPI, or during interactive provisioning via a Web Portal. They may also be set from within the instance with the mdata-put command.
The key-value pair for keyname will be removed permanently from the metadata stored for this guest instance. Deletion of a key which did not exist is not considered an error.
If the metadata service is unavailable at the time of the request, this command will block waiting for it to become available. Non-transient failures will cause the program to exit with a non-zero status. Depending on the nature of the error, some diagnostic output may be printed to stderr.
EXIT STATUS
The following exit values are returned:
0
The key-value pair named keyname was removed from the instance metadata, or did not initially exist.
2
An unexpected error condition occurred, which is believed to be a non-transient condition. Retrying the request is not expected to resolve the error condition; either a software bug or misconfiguration exists.
3
Malformed arguments were passed to the program. Check the usage instructions to ensure valid arguments are supplied.
SEE ALSO
mdata-get(1), mdata-list(1), mdata-put(1)
| October 2013 | Joyent SmartDataCenter |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.