VMware Cloud Director API - POST-CreateFileDescriptor

POST /admin/extension/service/apidefinition/{id}/files

Operation:

POST /admin/extension/service/apidefinition/{id}/files

Description:

Creates file descriptor.

Since:

5.1

Input parameters

The data needed to create {@link AdminFileDescriptorType}

Consume media type(s):: application/vnd.vmware.admin.fileDescriptor+xml
application/vnd.vmware.admin.fileDescriptor+json
Input type:: AdminFileDescriptorType

Output parameters

{@link AdminFileDescriptorType}

Produce media type(s):: application/vnd.vmware.admin.fileDescriptor+xml
application/vnd.vmware.admin.fileDescriptor+json
Output type:: AdminFileDescriptorType

Examples

Request: HTTP 1.1
POST /api/admin/extension/service/apidefinition/f273f407-4beb-4e9f-8259-2d0e507d222b/files

Headers:
Content-Length: 377
Content-Type: application/vnd.vmware.admin.fileDescriptor+xml; charset=ISO-8859-1
x-vcloud-authorization: SZMKkKToUBmDWSEeqZYL2yxpCqDiyToj5PYW3TigOrI=

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:FileDescriptor
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    operationKey="35c5f42b-9064-4206-9c38-6d5928d144d6">
    <vmext:Description>Description</vmext:Description>
    <vmext:File
        href="{baseUri}/loadBalancerDescriptors/descriptors1.zip"
        name="descriptorsArchive1"
        type="application/zip"/>
</vmext:FileDescriptor>
Response: HTTP/1.1 201 Created

Headers:
Content-Length: 1186
Content-Type: application/vnd.vmware.admin.filedescriptor+xml;version=5.5
Location: https://vcloud.example.com/api/admin/extension/service/file/cb56fa8c-164c-4ab2-9f03-d9eca4a9372c
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:FileDescriptor
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    href="https://vcloud.example.com/api/admin/extension/service/file/cb56fa8c-164c-4ab2-9f03-d9eca4a9372c"
    id="urn:vcloud:apiFileDescriptor:cb56fa8c-164c-4ab2-9f03-d9eca4a9372c"
    type="application/vnd.vmware.admin.fileDescriptor+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/extension/v1.5 http://https://vcloud.example.com/api/v1.5/schema/vmwextensions.xsd http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/service/file/cb56fa8c-164c-4ab2-9f03-d9eca4a9372c"
        rel="remove"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/service/apidefinition/f273f407-4beb-4e9f-8259-2d0e507d222b"
        rel="up"
        type="application/vnd.vmware.admin.apiDefinition+xml"/>
    <vmext:Description>Description</vmext:Description>
    <vmext:File
        href="{baseUri}/loadBalancerDescriptors/descriptors1.zip"
        name="descriptorsArchive1"
        type="application/zip"/>
</vmext:FileDescriptor>