REST API - publish
  1. Operations
  2. content
  3. local library

content local library: publish

Publishes the library to specified subscriptions. If no subscriptions are specified, then publishes the library to all its subscriptions. This operation was added in vSphere API 6.7.2.

Request:

HTTP request

POST https://{server}/rest/com/vmware/content/local-library/id:{library_id}?~action=publish

Path Parameters

Name Type Description
Required
library_id string Identifier of the published library.

Request Body Structure:

{
    "subscriptions" : [
        {
            "subscription" : "obj-103"
        },
        {
            "subscription" : "obj-103"
        }
    ]
}

Request Body Parameters:

Name Type Description
bold = required
subscriptions destination_spec[] Optional. The list of subscriptions to publish this library to.
subscriptions[].subscription string Identifier of the subscription associated with the subscribed library. This attribute was added in vSphere API 6.7.2.

When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.content.library.Subscriptions. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.content.library.Subscriptions.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
500 error If the system reports an error while responding to the request.
404 not_found If the library specified by library_id does not exist.
400 invalid_argument If one or more subscriptions is not valid.
400 invalid_element_type If the library specified by library_id is a subscribed library.
400 not_allowed_in_current_state If the library specified by library_id is not a published library.
401 unauthenticated If the user that requested the operation cannot be authenticated.
403 unauthorized If the user that requested the operation is not authorized to perform the operation.