1. Types
  2. content
  3. library

content library: publish info

The publish_info structure defines how a local library is published publicly for synchronization to other libraries.

Representation:

{
    "authentication_method": "BASIC",
    "current_password": "secret string",
    "password": "secret string",
    "persist_json_enabled": true,
    "publish_url": "http://myurl.com",
    "published": true,
    "user_name": "string"
}

Attributes:

Name Type Description
Optional
authentication_method string Indicates how a subscribed library should authenticate (BASIC, NONE) to the published library endpoint.

Indicates how a subscribed library should authenticate to the published library endpoint. Value is one of:
BASIC: Require HTTP Basic authentication matching a specified username and password.
NONE: Require no authentication.Optional. This field is required for the create operation. It is optional for the update operation, and if unset the value will not be changed. When the existing authentication method is BASIC and authentication is being turned off by updating this field to NONE, then the content.library.publish_info.current_password field is required. This field will always be present in the results of the get operation.
published boolean Whether the local library is published.

Optional. This field is required for the create operation. It is optional for the update operation, and if unset the value will not be changed. When the existing authentication method is BASIC and the local library is published, the content.library.publish_info.current_password field is required before turning off publishing. This field will always be present in the results of the get operation.
publish_url URI The URL to which the library metadata is published by the Content Library Service.

This value can be used to set the content.library.subscription_info.subscription_url property when creating a subscribed library.

Optional. This field is not used for the create operation. It will always be present in the result of the get or list operations. It is not used for the update operation.
user_name string The username to require for authentication.

Optional. This field is optional for the create and update operations. When the authentication method is NONE, the username can be left unset. When the authentication method is BASIC, the username is ignored in the current release. It defaults to "vcsp". It is preferable to leave this unset. If specified, it must be set to "vcsp".
password secret The new password to require for authentication.

Optional. This field is optional for the create operation. When the authentication method is NONE, the password can be left unset. When the authentication method is BASIC, the password should be a non-empty string. This field is optional for the update operation. Leaving it unset during update indicates that the password is not changed. When the password is changed, the content.library.publish_info.current_password field is required. This field is not used for the get operation.
current_password secret The current password to verify. This field is available starting in vSphere 6.7.

Optional. This field is unused for the create operation. This field is optional for the update operation. When the existing authentication method is NONE, the current password can be left unset. When the existing authentication method is BASIC, the current password is verified before applying the new content.library.publish_info.password, turning off authentication, or unpublishing the library. This field is not used for the get operation.
persist_json_enabled boolean Whether library and library item metadata are persisted in the storage backing as JSON files. This flag only applies if the local library is published.

Enabling JSON persistence allows you to synchronize a subscribed library manually instead of over HTTP. You copy the local library content and metadata to another storage backing manually and then create a subscribed library referencing the location of the library JSON file in the content.library.subscription_info.subscription_url. When the subscribed library's storage backing matches the subscription URL, files do not need to be copied to the subscribed library.

For a library backed by a datastore, the library JSON file will be stored at the path contentlib-{library_id}/lib.json on the datastore.

For a library backed by a remote file system, the library JSON file will be stored at {library_id}/lib.json in the remote file system path.

Optional. This field is optional for the create operation. It will always be present in the result of the get or list operations. It is optional for the update operation.