com.iland.core.web.rest.api

Interface VdcResource

All Superinterfaces:

Serializable

@Path(value="/vdcs")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
public interface VdcResource
extends Serializable

Vdc Resource Interface v1.

Author:

Cory Snyder

Method Summary

Modifier and Type	Method and Description
TaskResponse	addVappFromTemplate(String vdcUuid, VdcAddVappFromTemplateRequest request) Add a vApp from a vApp template.
TaskResponse	buildVapp(String vdcUuid, BuildVappRequest spec) Create a vApp from scratch to the given VDC.
IpSetResponse	createIpSet(String vdcUuid, IpSetCreateRequest ipSetCreateRequest) Create a IP set grouping object for a given vDC.
MacSetResponse	createMacSet(String vdcUuid, MacSetCreateRequest macSetCreateRequest) Create a MAC set grouping object for a given vDC.
TaskResponse	createVmAffinityRule(String vdcUuid, VmAffinityRuleCreateRequest request) Create a vm affinity rule.
void	deleteIpSet(String vdcUuid, String ipSetId) Delete the specified IP set.
void	deleteMacSet(String vdcUuid, String macSetUuid) Delete the specified MAC set.
TaskResponse	deleteMetadataForVdc(String vdcUuid, String key) Delete a specific piece of metadata associated with a Vdc by its key.
TaskResponse	deleteVmAffinityRule(String vdcUuid, String ruleUuid) Deletes a given vm affinity rule.
TaskResponse	generateVmInventoryReportForVdc(String vdcUuid, boolean emailOnCompletion, String email) Generate a VM inventory report for the specified vDC.
ApplicationResponse	getApplication(String vdcUuid, String applicationId) Get the specified application group for the given vDC.
ApplicationGroupResponse	getApplicationGroup(String vdcUuid, String applicationId) Get a specified application group for a given vDC.
ApplicationGroupListResponse	getApplicationGroups(String vdcUuid) Get a list application group grouping objects for a given vDC.
ApplicationListResponse	getApplications(String vdcUuid) Get all the application grouping objects for a given vDC.
BillResponse	getBillingForVdc(String vdcUuid, Integer year, Integer month) Returns vDC billing for a given invoice period.
BillingSampleSerieResponse	getCostOverInvoicePeriodSerie(String vdcUuid, Integer year, Integer month, List<String> additionalFields) Get a serie detailing the hourly cost over an invoice period for a given vDC.
EdgeListResponse	getEdgesForVdc(String vdcUuid) Get the edges for the vDC.
IpSetResponse	getIpSet(String vdcUuid, String ipSetId) Get the specified IP set given it's UUID.
IpSetListResponse	getIpSets(String vdcUuid) Get all the IP sets for a given vDC.
MacSetResponse	getMacSet(String vdcUuid, String macSetUuid) Get the specified MAC set given it's UUID.
MacSetListResponse	getMacSets(String vdcUuid) Get all the MAC sets for a given vDC.
MediaListResponse	getMediasForVdc(String vdcUuid) Get medias available to a given Vdc.
MetadataListResponse	getMetadataForVdc(String vdcUuid) Retrieve metadata associated with a Vdc.
OrgVdcNetworkListResponse	getOrgVdcNetworksForVdc(String vdcUuid) Get org vdc networks for a given VDC.
PerformanceCounterListResponse	getPerformanceCountersForVdc(String vdcUuid) Get the list of performance counters that can be used to query for vDC performance data.
PerfSampleSerieResponse	getPerformanceForVdc(String vdcUuid, String group, String name, String type, Long start, Long end, String interval, String limit) Get VDC performance data for the given VDC, counter, and time range.
StorageProfileListResponse	getStorageProfiles(String vdcUuid, Boolean includeDisabled) Get the storage profiles available to the vDC.
VdcStorageProfileSummaryResponse	getStorageProfileSummary(String vdcUuid, Integer year, Integer month) Gets a summary of storage profile usage for a specified vDC and billing period.
VdcResourceSummaryResponse	getSummaryForVdc(String vdcUuid) Get the resource summary for the given VDC.
BillListResponse	getVappBills(String vdcUuid, Integer month, Integer year) Gets all vapp bills for a specified vDC.
VappResourceSummaryMapResponse	getVappResourceSummaries(String vdcUuid) Get the map of resource summaries for all vApps in the given vDC.
VappListResponse	getVappsForVdc(String vdcUuid) Get a list of vApps for a VDC.
VdcResponse	getVdc(String vdcUuid, Long timestamp) Get a VDC by its UUID.
BillingSummaryResponse	getVdcCurrentBilling(String vdcUuid) Get the current billing for a VDC.
VmAffinityRuleListResponse	getVmAffinityRules(String vdcUuid) Get all the vm affinity rules for a given vDC.
BillListResponse	getVmBills(String vdcUuid, Integer month, Integer year) Gets all vm bills for a specified vDC.
ReportHeaderListResponse	getVmInventoryReportsForVdc(String vdcUuid, ReportFormat reportFormat) Get the VM inventory reports for vDC.
VmResourceSummaryMapResponse	getVmResourceSummaries(String vdcUuid) Get the map of resource summaries for all VMs in the given vDC.
VmListResponse	getVmsForVdc(String vdcUuid) Get a list of VMs for a VDC.
void	sendEventHistoryForVdc(String vdcUuid, EventHistoryEmailRequest spec) Email a CSV report with all event history for a given Vdc.
IpSetResponse	updateIpSet(String vdcUuid, String ipSetId, IpSetUpdateRequest ipSetUpdateRequest) Updates a IP set grouping object for a given vDC.
MacSetResponse	updateMacSet(String vdcUuid, String macSetUuid, MacSetUpdateRequest macSetUpdateRequest) Updates a MAC set grouping object for a given vDC.
TaskResponse	updateMetadataForVdc(String vdcUuid, List<UpdateMetadataRequest> metadata) Add / update metadata associated with a Vdc.
TaskResponse	updateVmAffinityRule(String vdcUuid, VmAffinityRuleUpdateRequest vmAffinityRuleUpdateRequest) Update the given vm affinity rule.

Method Detail

getVdc

@GET
 @Path(value="/{vdcUuid}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VdcResponse getVdc(@PathParam(value="vdcUuid")
                                                                                                                String vdcUuid,
                                                                                                                @QueryParam(value="timestamp")
                                                                                                                Long timestamp)

Get a VDC by its UUID.

Parameters:

vdcUuid - vdc uuid

timestamp - optional timestamp parameter to get the vDC details at a certain point in time.

Returns:

virtual data center

getVappsForVdc

@GET
 @Path(value="/{vdcUuid}/vapps")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VappListResponse getVappsForVdc(@PathParam(value="vdcUuid")
                                                                                                                                   String vdcUuid)

Get a list of vApps for a VDC.

Parameters:

vdcUuid - vdc uuid

Returns:

list of vApps for the VDC

getVmsForVdc

@GET
 @Path(value="/{vdcUuid}/vms")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VmListResponse getVmsForVdc(@PathParam(value="vdcUuid")
                                                                                                                             String vdcUuid)

Get a list of VMs for a VDC.

Parameters:

vdcUuid - vdc uuid

Returns:

list of VMs for the VDC

getVdcCurrentBilling

@GET
 @Path(value="/{vdcUuid}/billing-summary")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
BillingSummaryResponse getVdcCurrentBilling(@PathParam(value="vdcUuid")
                                                                                                                                                         String vdcUuid)

Get the current billing for a VDC.

Excluded from public API as its really only intended for consumption in console.

Parameters:

vdcUuid - vdc uuid

Returns:

current billing for the VDC

getBillingForVdc

@GET
 @Path(value="/{vdcUuid}/billing")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
BillResponse getBillingForVdc(@PathParam(value="vdcUuid")
                                                                                                                                   String vdcUuid,
                                                                                                                                   @QueryParam(value="year")
                                                                                                                                   Integer year,
                                                                                                                                   @QueryParam(value="month")
                                                                                                                                   Integer month)

Returns vDC billing for a given invoice period.

If month and year are not explicitly supplied the current invoice period is used.

Parameters:

vdcUuid - vdc uuid

year - the invoice period year (defaults to current year)

month - the invoice period month (defaults to the current month) must be in range 1-12

Returns:

billing for the vDC and given invoice period

getVappBills

@GET
 @Path(value="/{vdcUuid}/vapp-bills")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
BillListResponse getVappBills(@PathParam(value="vdcUuid")
                                                                                                                                      String vdcUuid,
                                                                                                                                      @QueryParam(value="month")
                                                                                                                                      Integer month,
                                                                                                                                      @QueryParam(value="year")
                                                                                                                                      Integer year)

Gets all vapp bills for a specified vDC. Returns the current month bills by default, but query parameters can be used to select an earlier set of bills.

Parameters:

vdcUuid - vdc uuid

Returns:

vapp bills for the specified vDC

getVmBills

@GET
 @Path(value="/{vdcUuid}/vm-bills")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
BillListResponse getVmBills(@PathParam(value="vdcUuid")
                                                                                                                                  String vdcUuid,
                                                                                                                                  @QueryParam(value="month")
                                                                                                                                  Integer month,
                                                                                                                                  @QueryParam(value="year")
                                                                                                                                  Integer year)

Gets all vm bills for a specified vDC. Returns the current month bills by default, but query parameters can be used to select an earlier set of bills.

Parameters:

vdcUuid - vdc uuid

Returns:

vm bills for the specified vDC

sendEventHistoryForVdc

@POST
 @Path(value="/{vdcUuid}/actions/email-event-history")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
void sendEventHistoryForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                      String vdcUuid,
                                                                                                                                                      EventHistoryEmailRequest spec)

Email a CSV report with all event history for a given Vdc.

Parameters:

vdcUuid - vdc uuid

spec - email address spec

getMetadataForVdc

@GET
 @Path(value="/{vdcUuid}/metadata")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
MetadataListResponse getMetadataForVdc(@PathParam(value="vdcUuid")
                                                                                                                                             String vdcUuid)

Retrieve metadata associated with a Vdc.

Parameters:

vdcUuid - vdc uuid

Returns:

list of metadata for the given vdc

updateMetadataForVdc

@PUT
 @Path(value="/{vdcUuid}/metadata")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse updateMetadataForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                                             String vdcUuid,
                                                                                                                                                                             List<UpdateMetadataRequest> metadata)

Add / update metadata associated with a Vdc.

Parameters:

vdcUuid - vdc uuid

metadata - of instances

Returns:

asynchronous task details

deleteMetadataForVdc

@DELETE
 @Path(value="/{vdcUuid}/metadata/{key}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse deleteMetadataForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                 String vdcUuid,
                                                                                                                                                 @PathParam(value="key")
                                                                                                                                                 String key)

Delete a specific piece of metadata associated with a Vdc by its key.

Parameters:

vdcUuid - vdc uuid

key - metadata key

Returns:

asynchronous task details

getMediasForVdc

@GET
 @Path(value="/{vdcUuid}/medias")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
MediaListResponse getMediasForVdc(@PathParam(value="vdcUuid")
                                                                                                                                      String vdcUuid)

Get medias available to a given Vdc.

Parameters:

vdcUuid - vdc uuid

Returns:

list of medias for the vdc

getStorageProfiles

@GET
 @Path(value="/{vdcUuid}/storage-profiles")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
StorageProfileListResponse getStorageProfiles(@PathParam(value="vdcUuid")
                                                                                                                                                            String vdcUuid,
                                                                                                                                                            @QueryParam(value="includeDisabled")
                                                                                                                                                            Boolean includeDisabled)

Get the storage profiles available to the vDC.

Parameters:

vdcUuid - vdc uuid

includeDisabled - whether to include disabled profiles (defaults to false if not explicitly provided)

Returns:

list of storage profiles available to the VDC

addVappFromTemplate

@POST
 @Path(value="/{vdcUuid}/actions/add-vapp-from-template")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse addVappFromTemplate(@PathParam(value="vdcUuid")
                                                                                                                                                                                                   String vdcUuid,
                                                                                                                                                                                                   VdcAddVappFromTemplateRequest request)

Add a vApp from a vApp template.

Parameters:

vdcUuid - vdc uuid

request - specification for new vApp paramters

Returns:

asynchronous task details

buildVapp

@POST
 @Path(value="/{vdcUuid}/actions/build-vapp")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse buildVapp(@PathParam(value="vdcUuid")
                                                                                                                                                                             String vdcUuid,
                                                                                                                                                                             BuildVappRequest spec)

Create a vApp from scratch to the given VDC.

Parameters:

vdcUuid - vdc uuid

spec - specification for the new vApp

Returns:

asynchronous task details

getOrgVdcNetworksForVdc

@GET
 @Path(value="/{vdcUuid}/org-vdc-networks")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
OrgVdcNetworkListResponse getOrgVdcNetworksForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                                String vdcUuid)

Get org vdc networks for a given VDC.

Parameters:

vdcUuid - vdc uuid

Returns:

list of networks

getPerformanceForVdc

@GET
 @Path(value="/{vdcUuid}/performance/{group}::{name}::{type}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
PerfSampleSerieResponse getPerformanceForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                                              String vdcUuid,
                                                                                                                                                                              @PathParam(value="group")
                                                                                                                                                                              String group,
                                                                                                                                                                              @PathParam(value="name")
                                                                                                                                                                              String name,
                                                                                                                                                                              @PathParam(value="type")
                                                                                                                                                                              String type,
                                                                                                                                                                              @QueryParam(value="start")
                                                                                                                                                                              Long start,
                                                                                                                                                                              @QueryParam(value="end")
                                                                                                                                                                              Long end,
                                                                                                                                                                              @QueryParam(value="interval")
                                                                                                                                                                              String interval,
                                                                                                                                                                              @QueryParam(value="limit")
                                                                                                                                                                              String limit)

Get VDC performance data for the given VDC, counter, and time range.

Parameters:

vdcUuid - vDC UUID

group - the performance counter group

name - the performance counter name

type - the performance counter type

start - start date

end - end date

interval - interval

limit - limit

Returns:

performance samples serie for the given vdc, counter and date range

getPerformanceCountersForVdc

@GET
 @Path(value="/{vdcUuid}/performance-counters")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
PerformanceCounterListResponse getPerformanceCountersForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                                              String vdcUuid)

Get the list of performance counters that can be used to query for vDC performance data.

Parameters:

vdcUuid - vDC UUID

Returns:

the list of performance counters

getSummaryForVdc

@GET
 @Path(value="/{vdcUuid}/summary")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VdcResourceSummaryResponse getSummaryForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                 String vdcUuid)

Get the resource summary for the given VDC.

Parameters:

vdcUuid - vdc uuid

Returns:

vdc resource summary

getVappResourceSummaries

@GET
 @Path(value="{vdcUuid}/vapp-summary-map")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VappResourceSummaryMapResponse getVappResourceSummaries(@PathParam(value="vdcUuid")
                                                                                                                                                                     String vdcUuid)

Get the map of resource summaries for all vApps in the given vDC.

Parameters:

vdcUuid - vdc uuid

Returns:

map of vApp uuid to vApp resource summary

getVmResourceSummaries

@GET
 @Path(value="{vdcUuid}/vm-summary-map")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VmResourceSummaryMapResponse getVmResourceSummaries(@PathParam(value="vdcUuid")
                                                                                                                                                               String vdcUuid)

Get the map of resource summaries for all VMs in the given vDC.

Parameters:

vdcUuid - vdc uuid

Returns:

map of VM uuid to vm resource summary

getEdgesForVdc

@GET
 @Path(value="/{vdcUuid}/edges")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
EdgeListResponse getEdgesForVdc(@PathParam(value="vdcUuid")
                                                                                                                                   String vdcUuid)

Get the edges for the vDC.

Parameters:

vdcUuid - vdc uuid

Returns:

a list of vcd edges

getStorageProfileSummary

@GET
 @Path(value="/{vdcUuid}/storage-profile-summary")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VdcStorageProfileSummaryResponse getStorageProfileSummary(@PathParam(value="vdcUuid")
                                                                                                                                                                               String vdcUuid,
                                                                                                                                                                               @QueryParam(value="year")
                                                                                                                                                                               Integer year,
                                                                                                                                                                               @QueryParam(value="month")
                                                                                                                                                                               Integer month)

Gets a summary of storage profile usage for a specified vDC and billing period.

Parameters:

vdcUuid - the UUID of the vDC

year - the year

month - the month in range 1-12

Returns:

a summary of storage profile usage

getCostOverInvoicePeriodSerie

@GET
 @Path(value="/{vdcUuid}/cost-over-invoice-period")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
BillingSampleSerieResponse getCostOverInvoicePeriodSerie(@PathParam(value="vdcUuid")
                                                                                                                                                                               String vdcUuid,
                                                                                                                                                                               @QueryParam(value="year")
                                                                                                                                                                               Integer year,
                                                                                                                                                                               @QueryParam(value="month")
                                                                                                                                                                               Integer month,
                                                                                                                                                                               @QueryParam(value="additionalFields")
                                                                                                                                                                               List<String> additionalFields)

Get a serie detailing the hourly cost over an invoice period for a given vDC.

Parameters:

vdcUuid - the UUID of the vDC

year - the year

month - the month in range 1-12

additionalFields - any additional fields that should be included in the series

Returns:

a serie of samples detailing hourly vDC total cost by hour for the invoice period

generateVmInventoryReportForVdc

@POST
 @Path(value="/{vdcUuid}/actions/generate-vm-inventory-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateVmInventoryReportForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                                                String vdcUuid,
                                                                                                                                                                                @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                boolean emailOnCompletion,
                                                                                                                                                                                @QueryParam(value="email")
                                                                                                                                                                                String email)

Generate a VM inventory report for the specified vDC.

Only available report type of 'csv'

Parameters:

vdcUuid - String vdc uuid

emailOnCompletion - whether to email the report upon successful generation, superseded by BillingReportSpec's email property

email - email address to send the report to if emailOnCompletion is true, defaults to the user's profile email if not specified

Returns:

asynchronous task details

getVmInventoryReportsForVdc

@GET
 @Path(value="/{vdcUuid}/vm-inventory-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getVmInventoryReportsForVdc(@PathParam(value="vdcUuid")
                                                                                                                                                                       String vdcUuid,
                                                                                                                                                                       @QueryParam(value="format")
                                                                                                                                                                       ReportFormat reportFormat)

Get the VM inventory reports for vDC.

The endpoint also supports filtering by report format, using the query param "format".

Report formats available to filter on include:

• PDF
• HTML
• CSV

Parameters:

vdcUuid - virtual data center uuid

Returns:

list of reports available for download

createVmAffinityRule

@POST
 @Path(value="/{vdcUuid}/actions/create-vm-affinity-rule")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse createVmAffinityRule(@PathParam(value="vdcUuid")
                                                                                                                                                                                                     String vdcUuid,
                                                                                                                                                                                                     VmAffinityRuleCreateRequest request)

Create a vm affinity rule.

Parameters:

request - vm affinity rule create request

Returns:

core task

updateVmAffinityRule

@PUT
 @Path(value="/{vdcUuid}/actions/update-vm-affinity-rule")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse updateVmAffinityRule(@PathParam(value="vdcUuid")
                                                                                                                                                                                                    String vdcUuid,
                                                                                                                                                                                                    VmAffinityRuleUpdateRequest vmAffinityRuleUpdateRequest)

Update the given vm affinity rule.

Parameters:

vdcUuid - virtual data center uuid

vmAffinityRuleUpdateRequest - vm affinity rule update request

Returns:

a task response

deleteVmAffinityRule

@DELETE
 @Path(value="/{vdcUuid}/actions/delete-vm-affinity-rule/{ruleUuid}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse deleteVmAffinityRule(@PathParam(value="vdcUuid")
                                                                                                                                                                             String vdcUuid,
                                                                                                                                                                             @PathParam(value="ruleUuid")
                                                                                                                                                                             String ruleUuid)

Deletes a given vm affinity rule.

Parameters:

vdcUuid - virtual data center uuid

ruleUuid - vm affinity rule uuid

Returns:

a task response

getVmAffinityRules

@GET
 @Path(value="/{vdcUuid}/vm-affinity-rules")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VmAffinityRuleListResponse getVmAffinityRules(@PathParam(value="vdcUuid")
                                                                                                                                                             String vdcUuid)

Get all the vm affinity rules for a given vDC.

Parameters:

vdcUuid - vdc uuid

Returns:

a vm affinity rule list response

createIpSet

@POST
 @Path(value="/{vdcUuid}/ipsets")
 @Consumes(value="application/json")
IpSetResponse createIpSet(@PathParam(value="vdcUuid")
                                                                                                       String vdcUuid,
                                                                                                       IpSetCreateRequest ipSetCreateRequest)

Create a IP set grouping object for a given vDC.

Parameters:

vdcUuid - vDC uuid

ipSetCreateRequest - ip set create request

Returns:

created ip set

getIpSets

@GET
 @Path(value="/{vdcUuid}/ipsets")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
IpSetListResponse getIpSets(@PathParam(value="vdcUuid")
                                                                                                                                String vdcUuid)

Get all the IP sets for a given vDC.

Parameters:

vdcUuid - vDC uuid

Returns:

ip set list response

createMacSet

@POST
 @Path(value="/{vdcUuid}/macsets")
 @Consumes(value="application/json")
MacSetResponse createMacSet(@PathParam(value="vdcUuid")
                                                                                                          String vdcUuid,
                                                                                                          MacSetCreateRequest macSetCreateRequest)

Create a MAC set grouping object for a given vDC.

Parameters:

vdcUuid - vDC uuid

macSetCreateRequest - mac set create request

Returns:

created mac set

getMacSets

@GET
 @Path(value="/{vdcUuid}/macsets")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
MacSetListResponse getMacSets(@PathParam(value="vdcUuid")
                                                                                                                                   String vdcUuid)

Get all the MAC sets for a given vDC.

Parameters:

vdcUuid - vDC uuid

Returns:

mac set list response

getIpSet

@GET
 @Path(value="/{vdcUuid}/ipsets/{ipsetId}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
IpSetResponse getIpSet(@PathParam(value="vdcUuid")
                                                                                                                                     String vdcUuid,
                                                                                                                                     @PathParam(value="ipsetId")
                                                                                                                                     String ipSetId)

Get the specified IP set given it's UUID.

Parameters:

vdcUuid - vDC uuid

ipSetId - ip set id

Returns:

ip set response

updateIpSet

@PUT
 @Path(value="/{vdcUuid}/ipsets/{ipsetId}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
IpSetResponse updateIpSet(@PathParam(value="vdcUuid")
                                                                                                                                        String vdcUuid,
                                                                                                                                        @PathParam(value="ipsetId")
                                                                                                                                        String ipSetId,
                                                                                                                                        IpSetUpdateRequest ipSetUpdateRequest)

Updates a IP set grouping object for a given vDC.

Parameters:

vdcUuid - vDC uuid

ipSetId - ip set id

ipSetUpdateRequest - ip set update request

Returns:

created ip set

deleteIpSet

@DELETE
 @Path(value="/{vdcUuid}/ipsets/{ipsetId}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
void deleteIpSet(@PathParam(value="vdcUuid")
                                                                                                                                  String vdcUuid,
                                                                                                                                  @PathParam(value="ipsetId")
                                                                                                                                  String ipSetId)

Delete the specified IP set.

Parameters:

vdcUuid - vDC uuid

ipSetId - ip set id

getApplications

@GET
 @Path(value="/{vdcUuid}/applications")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ApplicationListResponse getApplications(@PathParam(value="vdcUuid")
                                                                                                                                                  String vdcUuid)

Get all the application grouping objects for a given vDC.

Parameters:

vdcUuid - vdc uuid

Returns:

a application grouping object list response

getApplication

@GET
 @Path(value="/{vdcUuid}/applications/{applicationId}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ApplicationResponse getApplication(@PathParam(value="vdcUuid")
                                                                                                                                                             String vdcUuid,
                                                                                                                                                             @PathParam(value="applicationId")
                                                                                                                                                             String applicationId)

Get the specified application group for the given vDC.

Parameters:

vdcUuid - vdc uuid

applicationId - application grouping object id

Returns:

a application grouping object

getApplicationGroups

@GET
 @Path(value="/{vdcUuid}/application-groups")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ApplicationGroupListResponse getApplicationGroups(@PathParam(value="vdcUuid")
                                                                                                                                                                  String vdcUuid)

Get a list application group grouping objects for a given vDC.

Parameters:

vdcUuid - vdc uuid

Returns:

a application group grouping object list response

getApplicationGroup

@GET
 @Path(value="/{vdcUuid}/application-groups/{applicationId}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ApplicationGroupResponse getApplicationGroup(@PathParam(value="vdcUuid")
                                                                                                                                                                             String vdcUuid,
                                                                                                                                                                             @PathParam(value="applicationId")
                                                                                                                                                                             String applicationId)

Get a specified application group for a given vDC.

Parameters:

vdcUuid - vdc uuid

applicationId - application group id

Returns:

a application group grouping object response

getMacSet

@GET
 @Path(value="/{vdcUuid}/macsets/{macsetUuid}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
MacSetResponse getMacSet(@PathParam(value="vdcUuid")
                                                                                                                                           String vdcUuid,
                                                                                                                                           @PathParam(value="macsetUuid")
                                                                                                                                           String macSetUuid)

Get the specified MAC set given it's UUID.

Parameters:

vdcUuid - vDC uuid

macSetUuid - mac set uuid

Returns:

mac set response

updateMacSet

@PUT
 @Path(value="/{vdcUuid}/macsets/{macsetUuid}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
MacSetResponse updateMacSet(@PathParam(value="vdcUuid")
                                                                                                                                              String vdcUuid,
                                                                                                                                              @PathParam(value="macsetUuid")
                                                                                                                                              String macSetUuid,
                                                                                                                                              MacSetUpdateRequest macSetUpdateRequest)

Updates a MAC set grouping object for a given vDC.

Parameters:

vdcUuid - vDC uuid

macSetUuid - mac set uuid

macSetUpdateRequest - mac set update request

Returns:

created mac set

deleteMacSet

@DELETE
 @Path(value="/{vdcUuid}/macsets/{macsetUuid}")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
void deleteMacSet(@PathParam(value="vdcUuid")
                                                                                                                                       String vdcUuid,
                                                                                                                                       @PathParam(value="macsetUuid")
                                                                                                                                       String macSetUuid)

Delete the specified MAC set.

Parameters:

vdcUuid - vDC uuid

macSetUuid - mac set uuid