List Associations

Marker is an opaque token that allows the caller to request the next page of tag associations. If unset or empty, first page of tag associations will be returned. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.vcenter.tagging.associations.Marker. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.vcenter.tagging.associations.Marker.

Header Parameters

string

vmware-api-session-id Required

Required session ID, obtained by first calling Create Session API

vmware-api-session-id example

"b00db39f948d13ea1e59b4d6fce56389"

Authentication

This operation uses the following authentication methods.

api_key

Response

Response Body

200 OK returns TaggingAssociationsListResult of type application/json

A page of the tag associations matching the iteration spec.

{
	"associations": [
		{
			"object": {
				"id": "string",
				"type": "string"
			},
			"tag": "string"
		}
	],
	"marker": "string",
	"status": "READY"
}

array of TaggingAssociationsSummary

associations Required

List of tag associations.

TaggingAssociationsLastIterationStatus

status Required

The last status for the iterator. A field of this type is returned as part of the result and indicates to the caller of the API whether it can continue to make requests for more data. The last status only reports on the state of the iteration at the time data was last returned. As a result, it not does guarantee if the next call will succeed in getting more data or not.

Failures to retrieve results will be returned as Error responses. These last statuses are only returned when the iterator is operating as expected.
READY : Iterator has more data pending and is ready to provide it. The caller can request the next page of data at any time. The number of results returned may be less than the usual size. In other words, the iterator may not fill the page. The iterator has returned at least 1 result.
END_OF_DATA : Iterator has finished iterating through its inventory. There are currently no more entities to return and the caller can terminate iteration. If the iterator returned some data, the marker may be set to allow the iterator to continue from where it left off when additional data does become available. This value is used to indicate that all available data has been returned by the iterator.

Possible values are: READY , END_OF_DATA

string

marker Optional

Marker is an opaque data structure that allows the caller to request the next page of tag associations. If unset or empty, there are no more tag associations to request. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.vcenter.tagging.associations.Marker. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.vcenter.tagging.associations.Marker.

PowerCLI Client SDK Example

Invoke-ListAssociations -Marker "MyMarker"

cURL Command

curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/tagging/associations

Errors

Error

400

com.vmware.vapi.std.errors.invalid_argument : if Associations.IterationSpec.marker is not a marker returned from an earlier invocation of this {@term operation).

Error

403

com.vmware.vapi.std.errors.unauthorized : if the user doesn’t have the required privileges.

Vendor Extensions

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

x-vmw-doc-operation: list

Availability

Added in 7.0.0