VMware Cloud Director API - ApiDefinition (extension/v1.5)

AdminApiDefinitionType

Element:

ApiDefinition (extension/v1.5)

Type:

AdminApiDefinitionType

Namespace:

http://www.vmware.com/vcloud/extension/v1.5

Description:

Represents an extension service API definition.

Since:

5.1

Schema:

services.xsd

Media type(s):

application/vnd.vmware.admin.apiDefinition+json
application/vnd.vmware.admin.apiDefinition+xml

Extends:

EntityType

XML Representation:

<ApiDefinition xmlns="http://www.vmware.com/vcloud/extension/v1.5" xmlns:vcloud_v1.5="http://www.vmware.com/vcloud/v1.5" href="xs:anyURI" type="xs:string" id="xs:string" operationKey="xs:string"
        name="xs:string">
    <vcloud_v1.5:Link href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"
            rel="xs:string" model="xs:string"/>
    <Description> xs:string </Description>
    <vcloud_v1.5:Tasks>
        <vcloud_v1.5:Task href="xs:anyURI" type="xs:string" id="xs:string" operationKey="xs:string"
                name="xs:string" status="xs:string" operation="xs:string" operationName="xs:string"
                serviceNamespace="xs:string" startTime="xs:dateTime" endTime="xs:dateTime" expiryTime="xs:dateTime"
                cancelRequested="xs:boolean">
            <vcloud_v1.5:Link href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"
                    rel="xs:string" model="xs:string"/>
            <Description> xs:string </Description>
            <vcloud_v1.5:Tasks> vcloud_v1.5:TasksInProgressType </vcloud_v1.5:Tasks>
            <vcloud_v1.5:Owner href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"/>
            <vcloud_v1.5:Error stackTrace="xs:string" message="xs:string" majorErrorCode="xs:int" minorErrorCode="xs:string"
                    vendorSpecificErrorCode="xs:string">
                <vcloud_v1.5:TenantError message="xs:string" majorErrorCode="xs:int" minorErrorCode="xs:string" vendorSpecificErrorCode="xs:string"/>
            </vcloud_v1.5:Error>
            <vcloud_v1.5:User href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"/>
            <vcloud_v1.5:Organization href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"/>
            <Progress> xs:int </Progress>
            <Params> ... </Params>
            <Details> xs:string </Details>
            <vcloud_v1.5:VcTaskList>
                <vcloud_v1.5:VcTask name="xs:string" moref="xs:string" status="xs:string" description="xs:string"
                        errorMessage="xs:string" objectName="xs:string" objectType="xs:string" objectMoref="xs:string"
                        virtualCenterID="xs:string" startTime="xs:dateTime" endTime="xs:dateTime"/>
            </vcloud_v1.5:VcTaskList>
            <vcloud_v1.5:Result>
                <ResultContent> ... </ResultContent>
                <vcloud_v1.5:ResultReference href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"/>
            </vcloud_v1.5:Result>
        </vcloud_v1.5:Task>
    </vcloud_v1.5:Tasks>
    <EntryPoint> xs:string </EntryPoint>
    <Namespace> xs:string </Namespace>
    <ApiVendor> xs:string </ApiVendor>
    <SupportedApiVersions>
        <Version> xs:string </Version>
    </SupportedApiVersions>
    <Files>
        <FileDescriptor href="xs:anyURI" type="xs:string" id="xs:string" operationKey="xs:string">
            <vcloud_v1.5:Link href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"
                    rel="xs:string" model="xs:string"/>
            <Description> xs:string </Description>
            <vcloud_v1.5:File href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"/>
        </FileDescriptor>
    </Files>
</ApiDefinition>

Attributes

Attribute	Type	Required	Modifiable	Since	Description
href	anyURI	No	always	5.1	The URI of the entity.
type	string	No	always	5.1	The MIME type of the entity.
id	string	No	none	5.1	The entity identifier, expressed in URN format. The value of this attribute uniquely identifies the entity, persists for the life of the entity, and is never reused.
operationKey	string	No	create	5.1	Optional unique identifier to support idempotent semantics for create and delete operations.
name	string	Yes	always	5.1	The name of the entity.

Elements

Element	Type	Required	Modifiable	Since	Description
ApiVendor	string	No	always	5.1	The name of the external service API vendor. Not required to be the same as the vendor of the external service this API definition is associated with. Must be <=255 characters.
Description	string	No	always	5.1	Optional description.
EntryPoint	string	No	always	5.1	The URL to which a client can send requests to this extension service API. URL string must be <=255 characters. Can include the variable {baseUri}, which represents the vCloud Director REST API base URL.
Files	AdminFileDescriptorsType	No	always	5.1	List of files associated with this extension service API definition.
Link	LinkType	No	none	5.1	A reference to an entity or operation associated with this object.
Namespace	string	No	always	5.1	The namespace of this external service API definition. Must be <=255 characters.
SupportedApiVersions	VersionsType (extension/v1.5)	No	always	5.1	Supported extension service API versions.
Tasks	TasksInProgressType	No	none	5.1	A list of queued, running, or recently completed tasks associated with this entity.
VCloudExtension	VCloudExtensionType	No	always	5.1	An optional extension element that can contain an arbitrary number of elements and attributes. Not related to extension services.

Operations

CRUD	Operation	Description	Since
create	POST /admin/extension/service/{id}/apidefinitions	Creates API definition.	5.1
read	GET /admin/extension/service/apidefinition/{id}	Retrieve API definition.	5.1
delete	DELETE /admin/extension/service/apidefinition/{id}	Deletes API definition.	5.1