POST /admin/org/{id}/catalogs

Operation:

POST /admin/org/{id}/catalogs

Description:

Create a catalog.

The catalog is created in the unpublished state.

Since:

0.9

Input parameters

Consume media type(s):

application/vnd.vmware.admin.catalog+xml

Input type:

AdminCatalogType

Output parameters

CatalogType

This operation is asynchronous. The response body includes a task that you can monitor to track the progress of the request.

Produce media type(s):

application/vnd.vmware.admin.catalog+xml

Output type:

AdminCatalogType

Examples

Request

HTTP 1.1
POST /api/admin/org/7cc8d565-1203-49bd-b50c-24e0acbaeb5a/catalogs

Headers:
Content-Length: 217
Content-Type: application/vnd.vmware.admin.catalog+xml; charset=ISO-8859-1
x-vcloud-authorization: FQMWZgFq5mhMRSpt2ecxnsAXTxRpxdbZ/z2u6uwEH+w=

Body:

<?xml version="1.0" encoding="UTF-8"?><vcloud:AdminCatalog
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    name="New Catalog">
    <vcloud:Description>Catalog Description</vcloud:Description>
</vcloud:AdminCatalog>

Response

HTTP/1.1 201 Created

Headers:
Content-Length: 4813
Content-Type: application/vnd.vmware.admin.catalog+xml;version=5.5
Location: https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><AdminCatalog
    xmlns="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859"
    id="urn:vcloud:catalog:2a8c1427-7ba9-4a5a-ba08-040b630d9859"
    name="New Catalog"
    type="application/vnd.vmware.admin.catalog+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <Link
        href="https://vcloud.example.com/api/admin/org/7cc8d565-1203-49bd-b50c-24e0acbaeb5a"
        rel="up"
        type="application/vnd.vmware.admin.organization+xml"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859"
        rel="alternate"
        type="application/vnd.vmware.vcloud.catalog+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/owner"
        rel="down"
        type="application/vnd.vmware.vcloud.owner+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/metadata"
        rel="down"
        type="application/vnd.vmware.vcloud.metadata+xml"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/catalogItems"
        rel="add"
        type="application/vnd.vmware.vcloud.catalogItem+xml"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/upload"
        rel="add"
        type="application/vnd.vmware.vcloud.media+xml"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/upload"
        rel="add"
        type="application/vnd.vmware.vcloud.uploadVAppTemplateParams+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859"
        rel="edit"
        type="application/vnd.vmware.admin.catalog+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859"
        rel="remove"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/copy"
        rel="copy"
        type="application/vnd.vmware.vcloud.copyOrMoveCatalogItemParams+xml"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/move"
        rel="move"
        type="application/vnd.vmware.vcloud.copyOrMoveCatalogItemParams+xml"/>
    <Link
        href="https://vcloud.example.com/api/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/captureVApp"
        rel="add"
        type="application/vnd.vmware.vcloud.captureVAppParams+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/publish"
        rel="publish"
        type="application/vnd.vmware.admin.publishCatalogParams+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/publishToExternalOrganizations"
        rel="publishToExternalOrganizations"
        type="application/vnd.vmware.admin.publishExternalLibraryParams+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859/action/subscribeToExternalLibrary"
        rel="subscribeToExternalLibrary"
        type="application/vnd.vmware.admin.externalLibrarySubscriptionParams+xml"/>
    <Description>Catalog Description</Description>
    <Tasks>
        <Task
            cancelRequested="false"
            expiryTime="2013-05-14T18:35:02.253+03:00"
            href="https://vcloud.example.com/api/task/67fee35d-f560-4181-a9b7-74102cb27b4a"
            id="urn:vcloud:task:67fee35d-f560-4181-a9b7-74102cb27b4a"
            name="task"
            operation="Creating Library New Catalog(2a8c1427-7ba9-4a5a-ba08-040b630d9859)"
            operationName="catalogCreateCatalog"
            serviceNamespace="com.vmware.vcloud"
            startTime="2013-02-13T18:35:02.253+02:00"
            status="running"
            type="application/vnd.vmware.vcloud.task+xml">
            <Link
                href="https://vcloud.example.com/api/task/67fee35d-f560-4181-a9b7-74102cb27b4a/action/cancel"
                rel="task:cancel"/>
            <Owner
                href="https://vcloud.example.com/api/admin/catalog/2a8c1427-7ba9-4a5a-ba08-040b630d9859"
                name="New Catalog"
                type="application/vnd.vmware.admin.catalog+xml"/>
            <User
                href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
                name="system"
                type="application/vnd.vmware.admin.user+xml"/>
            <Organization
                href="https://vcloud.example.com/api/org/7cc8d565-1203-49bd-b50c-24e0acbaeb5a"
                name="OrgName"
                type="application/vnd.vmware.vcloud.org+xml"/>
            <Details/>
        </Task>
    </Tasks>
    <Owner
        type="application/vnd.vmware.vcloud.owner+xml">
        <User
            href="https://vcloud.example.com/api/admin/user/6243d11d-2fad-4988-934c-4ada2bc3808b"
            name="system"
            type="application/vnd.vmware.admin.user+xml"/>
    </Owner>
    <CatalogItems/>
    <IsPublished>false</IsPublished>
    <DateCreated>2013-02-13T18:35:02.248+02:00</DateCreated>
    <VersionNumber>1</VersionNumber>
    <CatalogStorageProfiles/>
</AdminCatalog>