CIS REST APIs Operations Index
All available CIS REST APIs Operations.
CIS
Session
| post |
Create Session
Creates a session with the API. This is the equivalent of login. This operation exchanges user credentials supplied in the security context for a session token that is to be used for authenticating subsequent calls. To authenticate subsequent calls clients are expected to include the session token. For REST API calls the HTTP vmware-api-session-id header field should be used for this. |
| delete |
Delete Session
Terminates the validity of a session token. This is the equivalent of log out. A session token is expected as part of the request. |
| get |
Get Session
Returns information about the current session. This operation expects a valid session token to be supplied. A side effect of invoking this operation may be a change to the session's last accessed time to the current time if this is supported by the session implementation. Invoking any other operation in the API will also update the session's last accessed time. This API is meant to serve the needs of various front end projects that may want to display the name of the user. Examples of this include various web based user interfaces and logging facilities. |
Tasks
| get |
Get Tasks
Returns information about a task. |
| post |
Cancel Tasks
Cancel a running operation associated with the task. This is the best effort attempt. Operation may not be cancelled anymore once it reaches certain stage. |
| post |
List Tasks
Returns information about at most 1000 visible (subject to permission checks) tasks matching the Tasks.FilterSpec. All tasks must be in the same provider. |
Tagging
Category
| get |
List Category
Enumerates the categories in the system. To invoke this operation, you need the read privilege on the individual categories. The list will only contain those categories for which you have read privileges. |
| post |
Create Category
Creates a category. To invoke this operation, you need the create category privilege. |
| get |
Get Category
Fetches the category information for the given category identifier. In order to view the category information, you need the read privilege on the category. |
| patch |
Update Category
Updates an existing category. To invoke this operation, you need the edit privilege on the category. |
| delete |
Delete Category
Deletes an existing category. To invoke this operation, you need the delete privilege on the category. |
| post |
Add To Used By Category
Adds the usedByEntity to the CategoryModel.used-by subscribers set for the specified category. If the usedByEntity is already in the set, then this becomes an idempotent no-op. To invoke this operation, you need the modify CategoryModel.used-by privilege on the category. |
| post |
Remove From Used By Category
Removes the usedByEntity from the CategoryModel.used-by subscribers set. If the usedByEntity is not using this category, then this becomes a no-op. To invoke this operation, you need the modify CategoryModel.used-by privilege on the category. |
| post |
Revoke Propagating Permissions Category
Revokes all propagating permissions on the given category. You should then attach a direct permission with tagging privileges on the given category. To invoke this operation, you need category related privileges (direct or propagating) on the concerned category. |
| post |
List Used Categories Category
Enumerates all categories for which the usedByEntity is part of the CategoryModel.used-by subscribers set. To invoke this operation, you need the read privilege on the individual categories. |
Tag
| post |
Create Tag
Creates a tag. To invoke this operation, you need the create tag privilege on the input category. |
| get |
List Tag
Enumerates the tags in the system. To invoke this operation, you need read privilege on the individual tags. The list will only contain tags for which you have read privileges. |
| get |
Get Tag
Fetches the tag information for the given tag identifier. To invoke this operation, you need the read privilege on the tag in order to view the tag info. |
| patch |
Update Tag
Updates an existing tag. To invoke this operation, you need the edit privilege on the tag. |
| delete |
Delete Tag
Deletes an existing tag. To invoke this operation, you need the delete privilege on the tag. |
| post |
Add To Used By Tag
Adds the usedByEntity to the TagModel.used-by subscribers set. If the usedByEntity is already in the set, then this becomes a no-op. To invoke this operation, you need the modify TagModel.used-by privilege on the tag. |
| post |
Remove From Used By Tag
Removes the usedByEntity from the TagModel.used-by subscribers set. If the usedByEntity is not using this tag, then this becomes a no-op. To invoke this operation, you need modify TagModel.used-by privilege on the tag. |
| post |
Revoke Propagating Permissions Tag
Revokes all propagating permissions on the given tag. You should then attach a direct permission with tagging privileges on the given tag. To invoke this operation, you need tag related privileges (direct or propagating) on the concerned tag. |
| post |
List Tags For Category Tag
Enumerates all tags for the given category. To invoke this operation, you need the read privilege on the given category and the individual tags in that category. |
| post |
List Used Tags Tag
Enumerates all tags for which the usedByEntity is part of the TagModel.used-by subscribers set. To invoke this operation, you need the read privilege on the individual tags. |
Tag Association
| post |
Attach Tag Association
Attaches the given tag to the input object. The tag needs to meet the cardinality (CategoryModel.cardinality) and associability (CategoryModel.associable-types) criteria in order to be eligible for attachment. If the tag is already attached to the object, then this operation is a no-op and an error will not be thrown. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on the object. |
| post |
Attach Tag To Multiple Objects Tag Association
Attaches the given tag to the input objects. If a tag is already attached to the object, then the individual operation is a no-op and an error will not be added to TagAssociation.BatchResult.error-messages. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on each object. |
| post |
Detach Tag Association
Detaches the tag from the given object. If the tag is already removed from the object, then this operation is a no-op and an error will not be thrown. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on the object. |
| post |
Detach Tag From Multiple Objects Tag Association
Detaches the given tag from the input objects. If a tag is already removed from the object, then the individual operation is a no-op and an error will not be added to TagAssociation.BatchResult.error-messages. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on each object. |
| post |
List Attached Objects Tag Association
Fetches the list of attached objects for the given tag. To invoke this operation, you need the read privilege on the input tag. Only those objects for which you have the read privilege will be returned. |
| post |
Attach Multiple Tags To Object Tag Association
Attaches the given tags to the input object. If a tag is already attached to the object, then the individual operation is a no-op and an error will not be added to TagAssociation.BatchResult.error-messages. To invoke this operation, you need the read privilege on the object and the attach tag privilege on each tag. |
| post |
Detach Multiple Tags From Object Tag Association
Detaches the given tags from the input object. If a tag is already removed from the object, then the individual operation is a no-op and an error will not be added to TagAssociation.BatchResult.error-messages. To invoke this operation, you need the read privilege on the object and the attach tag privilege each tag. |
| post |
List Attachable Tags Tag Association
Fetches the list of attachable tags for the given object, omitting the tags that have already been attached. Criteria for attachability is calculated based on tagging cardinality (CategoryModel.cardinality) and associability (CategoryModel.associable-types) constructs. To invoke this operation, you need the read privilege on the input object. The list will only contain those tags for which you have read privileges. |
| post |
List Attached Objects On Tags Tag Association
Fetches the list of TagAssociation.TagToObjects describing the input tag identifiers and the objects they are attached to. To invoke this operation, you need the read privilege on each input tag. The TagAssociation.TagToObjects.object-ids will only contain those objects for which you have the read privilege. |
| post |
List Attached Tags Tag Association
Fetches the list of tags attached to the given object. To invoke this operation, you need the read privilege on the input object. The list will only contain those tags for which you have the read privileges. |
| post |
List Attached Tags On Objects Tag Association
Fetches the list of TagAssociation.ObjectToTags describing the input object identifiers and the tags attached to each object. To invoke this operation, you need the read privilege on each input object. The TagAssociation.ObjectToTags.tag-ids will only contain those tags for which you have the read privilege. |
