Changed2

[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]

vmware-cloud-director

Create Metadata Entry

Description

Creates a new entry.

Request

URL

post

https://{api_host}/cloudapi/1.0.0/entities/{id}/metadata

Copy

Path Parameters

string

id Required

the URN of the entity the entry is attached to.

Request Body

MetadataEntry of type(s) application/json Required

Show optional properties

{
	"keyValue": {
		"domain": "string",
		"key": "string",
		"value": {
			"type": "string",
			"value": {}
		}
	}
}

{
	"id": "string",
	"keyValue": {
		"domain": "string",
		"key": "string",
		"namespace": "string",
		"value": {
			"type": "string",
			"value": {}
		}
	},
	"persistent": false,
	"readOnly": false
}

KeyValue

keyValue Required

Containins core metadata entry data.

string

id Optional

boolean

persistent Optional

Persistent entries can be copied over on some entity operation, for example: | Creating a copy of an Org VDC | Capturing a vApp to a template | Instantiating a catalog item as a VM

boolean

readOnly Optional

The kind of level of access organizations of the entry’s domain have

Authentication

This operation uses the following authentication methods.

ApiKeyAuth

Response

Response Body

201 Created

Returns MetadataEntry of type(s) application/json;version=36.3

{
	"id": "string",
	"keyValue": {
		"domain": "string",
		"key": "string",
		"namespace": "string",
		"value": {
			"type": "string",
			"value": {}
		}
	},
	"persistent": false,
	"readOnly": false
}

KeyValue

keyValue Required

Containins core metadata entry data.

string

id Optional

boolean

persistent Optional

Persistent entries can be copied over on some entity operation, for example: | Creating a copy of an Org VDC | Capturing a vApp to a template | Instantiating a catalog item as a VM

boolean

readOnly Optional

The kind of level of access organizations of the entry’s domain have

202 Accepted

The request have been accepted and the task to monitor the request is in the Location header.

Operation doesn't return any data structure.

Errors

Error

400

Invalid configuration.

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"id":"string","keyValue":{"domain":"string","key":"string","namespace":"string","value":{"type":"string","value":{}}},"persistent":false,"readOnly":false}' https://{api_host}/cloudapi/1.0.0/entities/{id}/metadata

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:

x-vcloud-event: com/vmware/vcloud/event/metadata/create

vmware-cloud-director

What's changed in v36.3?

CHANGED (2)

Extension changed
x-vcloud-added-in

Response Body Changes

Changed from
to 202

Changed from
to 400

New in this version

Availability

Added in 37.0.0-alpha

Defined Entity Operations

post

Create Defined Entity

post

Create Metadata Entry Changed

delete

Delete Defined Entity

delete

Delete Metadata Entry Changed

get

Get Defined Entities By Entity Type

get

Get Defined Entities By Interface

get

Get Defined Entity

get

Get Metadata

get

Get Metadata Entry

get

Get Metadata File Content Introduced

post

Resolve Defined Entity

put

Update Defined Entity

put

Update Metadata Entry Changed

Create Metadata Entry

Request

URL

Path Parameters

Request Body

Authentication

ApiKeyAuth

Response

Response Body

201 Created

202 Accepted

Errors

Code Samples

cURL Command

Vendor Extensions

What's changed in v36.3?

Availability

On This Page

Defined Entity Operations

Was this page helpful?