com.iland.core.web.rest.api

Interface OrgReportingResource

All Superinterfaces:

Serializable

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

Org Reporting Resource V1.

Author:

Brett Snyder

Method Summary

Modifier and Type	Method and Description
TaskResponse	generateAntiMalwareReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the anti-malware report for the given organization and time range.
TaskResponse	generateBillingReport(String orgUuid, BillingReportRequest billingReportSpec, boolean emailOnCompletion, String email) Generate the billing report for a given organization.
TaskResponse	generateContinuityProtectionReport(String orgUuid, String reportFormat, boolean emailOnCompletion, String email) Generate a continuity protection summary report for the given organization.
TaskResponse	generateDPIEventHistoryReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the DPI event history report for the given organization and time range.
TaskResponse	generateDRAdminReport(String orgUuid, String reportFormat, boolean emailOnCompletion, String email) Generate the dr admin report for the given organization.
TaskResponse	generateEventHistoryReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the ecs event history report for the given organization and time range.
TaskResponse	generateFirewallEventHistoryReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the firewall event history report for the given organization and time range.
TaskResponse	generateHIPAAReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the HIPAA report for the given organization and time range.
TaskResponse	generateIntegrityEventHistoryReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the integrity event history report for the given organization and time range.
TaskResponse	generateLoginEventHistoryReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the login event history report for the given organization and time range.
TaskResponse	generateLogInspectionReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the log inspection report for the given organization and time range.
TaskResponse	generateSupportRequestReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the support request history report for the given organization and time range.
TaskResponse	generateVmEncryptionReport(String orgUuid, String reportFormat, boolean emailOnCompletion, String email) Generate the VM encryption report for the given organization.
TaskResponse	generateVmInventoryReport(String orgUuid, boolean emailOnCompletion, String email) Generate the vm inventory report for a given organization.
TaskResponse	generateVulnerabilityReport(String orgUuid, String reportFormat, boolean emailOnCompletion, String email) Generate the vulnerability report for the given organization.
TaskResponse	generateWebReputationEventHistoryReport(String orgUuid, Long start, Long end, String reportFormat, boolean emailOnCompletion, String email) Generate the web reputation event history report for the given organization and time range.
ReportHeaderListResponse	getAntimalwareEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the anti-malware reports available for download for the given organization.
AntimalwareOverTimeResponse	getAntimalwareOverTimeSerie(String orgUuid, Long start, Long end, Integer limit) Get the antimalware over time serie for the given organization and date range.
ReportHeaderListResponse	getBillingReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the billing reports for the organization.
ReportHeaderListResponse	getCloudEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the cloud event history reports available for download for the given organization.
ComplianceOverTimeResponse	getComplianceOverTimeSerie(String orgUuid, ComplianceOverTimeResponse.SerieType type, Long start, Long end, Integer limit) Get the compliance over time serie for the given organization and serie name.
ReportHeaderListResponse	getContinuityProtectionReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the continuity protection reports for the organization.
EventCountResponse	getCount(String orgUuid, String reportType, Long start, Long end) Get the number of events for the given organization, date range, and report type.
ReportHeaderListResponse	getDisasterRecoveryAdminReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the DR admin reports for the organization.
ReportHeaderListResponse	getDPIEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the DPI event reports available for download for the given organization.
ReportHeaderListResponse	getFirewallEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the firewall event reports available for download for the given organization.
FirewallOverTimeResponse	getFirewallOverTimeSerie(String orgUuid, Long start, Long end, Integer limit) Get the firewall over time serie for the given organization and date range.
ReportHeaderListResponse	getHIPAAReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the HIPAA reports available for download for the given organization.
ReportHeaderListResponse	getIntegrityEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the integrity event reports available for download for the given organization.
ReportHeaderListResponse	getLoginEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the login event history reports available for download for the given organization.
ReportHeaderListResponse	getLogInspectionEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the log inspection reports available for download for the given organization.
LogInspectionOverTimeResponse	getLogInspectionOverTimeSerie(String orgUuid, Long start, Long end, Integer limit) Get the log inspection over time serie for the given organization and date range.
ReportHeaderListResponse	getSupportRequestReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the support request reports available for download for the given organization.
ReportHeaderListResponse	getVMEncryptionReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the VM encryption reports available for download for the given organization.
ReportHeaderListResponse	getVmInventoryReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the VM inventory reports for the organization.
VulnerabilityOverTimeResponse	getVulnerabilityOverTimeSerie(String orgUuid, Long start, Long end, Integer limit) Get the vulnerability over time serie for the given organization and date range.
ReportHeaderListResponse	getVulnerabilityReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the vulnerability reports available for download for the given organization.
ReportHeaderListResponse	getWebReputationEventReports(String orgUuid, ReportFormat reportFormat, Boolean latest) Get the web reputation event reports available for download for the given organization.

Method Detail

generateVulnerabilityReport

@POST
 @Path(value="/{orgUuid}/actions/generate-vulnerability-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateVulnerabilityReport(@PathParam(value="orgUuid")
                                                                                                                                                                             String orgUuid,
                                                                                                                                                                             @QueryParam(value="format")
                                                                                                                                                                             String reportFormat,
                                                                                                                                                                             @QueryParam(value="emailOnCompletion")
                                                                                                                                                                             boolean emailOnCompletion,
                                                                                                                                                                             @QueryParam(value="email")
                                                                                                                                                                             String email)

Generate the vulnerability report for the given organization. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateAntiMalwareReport

@POST
 @Path(value="/{orgUuid}/actions/generate-antimalware-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateAntiMalwareReport(@PathParam(value="orgUuid")
                                                                                                                                                                         String orgUuid,
                                                                                                                                                                         @QueryParam(value="start")
                                                                                                                                                                         Long start,
                                                                                                                                                                         @QueryParam(value="end")
                                                                                                                                                                         Long end,
                                                                                                                                                                         @QueryParam(value="format")
                                                                                                                                                                         String reportFormat,
                                                                                                                                                                         @QueryParam(value="emailOnCompletion")
                                                                                                                                                                         boolean emailOnCompletion,
                                                                                                                                                                         @QueryParam(value="email")
                                                                                                                                                                         String email)

Generate the anti-malware report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateLogInspectionReport

@POST
 @Path(value="/{orgUuid}/actions/generate-log-inspection-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateLogInspectionReport(@PathParam(value="orgUuid")
                                                                                                                                                                              String orgUuid,
                                                                                                                                                                              @QueryParam(value="start")
                                                                                                                                                                              Long start,
                                                                                                                                                                              @QueryParam(value="end")
                                                                                                                                                                              Long end,
                                                                                                                                                                              @QueryParam(value="format")
                                                                                                                                                                              String reportFormat,
                                                                                                                                                                              @QueryParam(value="emailOnCompletion")
                                                                                                                                                                              boolean emailOnCompletion,
                                                                                                                                                                              @QueryParam(value="email")
                                                                                                                                                                              String email)

Generate the log inspection report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateEventHistoryReport

@POST
 @Path(value="/{orgUuid}/actions/generate-event-history-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateEventHistoryReport(@PathParam(value="orgUuid")
                                                                                                                                                                            String orgUuid,
                                                                                                                                                                            @QueryParam(value="start")
                                                                                                                                                                            Long start,
                                                                                                                                                                            @QueryParam(value="end")
                                                                                                                                                                            Long end,
                                                                                                                                                                            @QueryParam(value="format")
                                                                                                                                                                            String reportFormat,
                                                                                                                                                                            @QueryParam(value="emailOnCompletion")
                                                                                                                                                                            boolean emailOnCompletion,
                                                                                                                                                                            @QueryParam(value="email")
                                                                                                                                                                            String email)

Generate the ecs event history report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateSupportRequestReport

@POST
 @Path(value="/{orgUuid}/actions/generate-support-request-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateSupportRequestReport(@PathParam(value="orgUuid")
                                                                                                                                                                                String orgUuid,
                                                                                                                                                                                @QueryParam(value="start")
                                                                                                                                                                                Long start,
                                                                                                                                                                                @QueryParam(value="end")
                                                                                                                                                                                Long end,
                                                                                                                                                                                @QueryParam(value="format")
                                                                                                                                                                                String reportFormat,
                                                                                                                                                                                @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                boolean emailOnCompletion,
                                                                                                                                                                                @QueryParam(value="email")
                                                                                                                                                                                String email)

Generate the support request history report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateLoginEventHistoryReport

@POST
 @Path(value="/{orgUuid}/actions/generate-login-event-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateLoginEventHistoryReport(@PathParam(value="orgUuid")
                                                                                                                                                                               String orgUuid,
                                                                                                                                                                               @QueryParam(value="start")
                                                                                                                                                                               Long start,
                                                                                                                                                                               @QueryParam(value="end")
                                                                                                                                                                               Long end,
                                                                                                                                                                               @QueryParam(value="format")
                                                                                                                                                                               String reportFormat,
                                                                                                                                                                               @QueryParam(value="emailOnCompletion")
                                                                                                                                                                               boolean emailOnCompletion,
                                                                                                                                                                               @QueryParam(value="email")
                                                                                                                                                                               String email)

Generate the login event history report for the given organization and time range. There is a limit of 1 month duration for requesting login events and if no query params are provided for the time range it will fall back on the past week. Default format is pdf if format is unspecified.

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateFirewallEventHistoryReport

@POST
 @Path(value="/{orgUuid}/actions/generate-firewall-event-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateFirewallEventHistoryReport(@PathParam(value="orgUuid")
                                                                                                                                                                                     String orgUuid,
                                                                                                                                                                                     @QueryParam(value="start")
                                                                                                                                                                                     Long start,
                                                                                                                                                                                     @QueryParam(value="end")
                                                                                                                                                                                     Long end,
                                                                                                                                                                                     @QueryParam(value="format")
                                                                                                                                                                                     String reportFormat,
                                                                                                                                                                                     @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                     boolean emailOnCompletion,
                                                                                                                                                                                     @QueryParam(value="email")
                                                                                                                                                                                     String email)

Generate the firewall event history report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateIntegrityEventHistoryReport

@POST
 @Path(value="/{orgUuid}/actions/generate-integrity-event-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateIntegrityEventHistoryReport(@PathParam(value="orgUuid")
                                                                                                                                                                                       String orgUuid,
                                                                                                                                                                                       @QueryParam(value="start")
                                                                                                                                                                                       Long start,
                                                                                                                                                                                       @QueryParam(value="end")
                                                                                                                                                                                       Long end,
                                                                                                                                                                                       @QueryParam(value="format")
                                                                                                                                                                                       String reportFormat,
                                                                                                                                                                                       @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                       boolean emailOnCompletion,
                                                                                                                                                                                       @QueryParam(value="email")
                                                                                                                                                                                       String email)

Generate the integrity event history report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateDPIEventHistoryReport

@POST
 @Path(value="/{orgUuid}/actions/generate-dpi-event-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateDPIEventHistoryReport(@PathParam(value="orgUuid")
                                                                                                                                                                           String orgUuid,
                                                                                                                                                                           @QueryParam(value="start")
                                                                                                                                                                           Long start,
                                                                                                                                                                           @QueryParam(value="end")
                                                                                                                                                                           Long end,
                                                                                                                                                                           @QueryParam(value="format")
                                                                                                                                                                           String reportFormat,
                                                                                                                                                                           @QueryParam(value="emailOnCompletion")
                                                                                                                                                                           boolean emailOnCompletion,
                                                                                                                                                                           @QueryParam(value="email")
                                                                                                                                                                           String email)

Generate the DPI event history report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateDRAdminReport

@POST
 @Path(value="/{orgUuid}/actions/generate-dr-admin-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateDRAdminReport(@PathParam(value="orgUuid")
                                                                                                                                                                  String orgUuid,
                                                                                                                                                                  @QueryParam(value="format")
                                                                                                                                                                  String reportFormat,
                                                                                                                                                                  @QueryParam(value="emailOnCompletion")
                                                                                                                                                                  boolean emailOnCompletion,
                                                                                                                                                                  @QueryParam(value="email")
                                                                                                                                                                  String email)

Generate the dr admin report for the given organization. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateContinuityProtectionReport

@POST
 @Path(value="/{orgUuid}/actions/generate-continuity-protection-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateContinuityProtectionReport(@PathParam(value="orgUuid")
                                                                                                                                                                                            String orgUuid,
                                                                                                                                                                                            @QueryParam(value="format")
                                                                                                                                                                                            String reportFormat,
                                                                                                                                                                                            @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                            boolean emailOnCompletion,
                                                                                                                                                                                            @QueryParam(value="email")
                                                                                                                                                                                            String email)

Generate a continuity protection summary report for the given organization.

Parameters:

orgUuid - organization uuid

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateWebReputationEventHistoryReport

@POST
 @Path(value="/{orgUuid}/actions/generate-web-reputation-event-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateWebReputationEventHistoryReport(@PathParam(value="orgUuid")
                                                                                                                                                                                                String orgUuid,
                                                                                                                                                                                                @QueryParam(value="start")
                                                                                                                                                                                                Long start,
                                                                                                                                                                                                @QueryParam(value="end")
                                                                                                                                                                                                Long end,
                                                                                                                                                                                                @QueryParam(value="format")
                                                                                                                                                                                                String reportFormat,
                                                                                                                                                                                                @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                                boolean emailOnCompletion,
                                                                                                                                                                                                @QueryParam(value="email")
                                                                                                                                                                                                String email)

Generate the web reputation event history report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateVmEncryptionReport

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

Generate the VM encryption report for the given organization. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateHIPAAReport

@POST
 @Path(value="/{orgUuid}/actions/generate-hipaa-report")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateHIPAAReport(@PathParam(value="orgUuid")
                                                                                                                                                             String orgUuid,
                                                                                                                                                             @QueryParam(value="start")
                                                                                                                                                             Long start,
                                                                                                                                                             @QueryParam(value="end")
                                                                                                                                                             Long end,
                                                                                                                                                             @QueryParam(value="format")
                                                                                                                                                             String reportFormat,
                                                                                                                                                             @QueryParam(value="emailOnCompletion")
                                                                                                                                                             boolean emailOnCompletion,
                                                                                                                                                             @QueryParam(value="email")
                                                                                                                                                             String email)

Generate the HIPAA report for the given organization and time range. Default format is pdf if format is unspecified

Parameters:

orgUuid - organization uuid

start - start

end - end

reportFormat - report format ('pdf' or 'html')

emailOnCompletion - whether to email the report upon successful generation

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

generateBillingReport

@POST
 @Path(value="/{orgUuid}/actions/generate-billing-report")
 @Consumes(value="application/json")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
TaskResponse generateBillingReport(@PathParam(value="orgUuid")
                                                                                                                                                                                                      String orgUuid,
                                                                                                                                                                                                      BillingReportRequest billingReportSpec,
                                                                                                                                                                                                      @QueryParam(value="emailOnCompletion")
                                                                                                                                                                                                      boolean emailOnCompletion,
                                                                                                                                                                                                      @QueryParam(value="email")
                                                                                                                                                                                                      String email)

Generate the billing report for a given organization. Only available as report type of 'csv'. BillingReportSpec's json elements

Json String	Description
rows	Specify what billing report rows should contain. org, media, template, vdc, vapp, or vm. Only needed for custom billing report type.
date	Date for which billing month to get, any date in the current month will provide a billing report for the current month up to that date.
email	Email address to send the report to. This property supersedes emailOnCompletion and email Query Params.
filename	Name of the billing report file to be returned.
type	Required field, specify the type of report you want.

Type	Description
basic	Rows include Org and Vdc resources
detailed	Rows include Org, Media, Template, VDC, vAPP and VM.
custom	Rows specified by rows json element.

custom_columns	Specify the column order and column type

Column Name	Description
cpu_usage	Usage of the CPU resource in GHz·h.
cpu_total_cost	Total cost of the CPU resource.
cpu_reserve_usage	Usage of the reserved portion of the CPU resource in .
cpu_reserve_cost	Cost of the reserved portion of the CPU resource.
cpu_burst_usage	Usage of the burst portion of the CPU resource in GHz·h.
cpu_burst_cost	Cost of the burst portion of the CPU resource.
ram_usage	Usage of the RAM resource in GB·h.
ram_total_cost	Total cost of the RAM resource.
ram_reserve_usage	Usage of the reserved portion of the RAM resource in GB·h.
ram_reserve_cost	Cost of the reserved portion of the RAM resource.
ram_burst_usage	Usage of the burst portion of the RAM resource in GB·h.
ram_burst_cost	Cost of the burst portion of the RAM resource.
hdd_reserve_cost	Cost of the reserved portion of the HDD resource.
hdd_reserve_usage	Usage of the reserved portion of the HDD resource in GB·h.
hdd_burst_usage	Usage of the burst portion of the HDD resource in GB·h.
hdd_burst_cost	Cost of the burst portion of the HDD resource.
hdd_total_usage	Total usage of the HDD resource in GB·h.
hdd_total_cost	Total cost of the HDD resource.
ssd_reserve_usage	Usage of the reserved portion of the SSD resource in GB·h.
ssd_reserve_cost	Cost of the reserved portion of the SSD resource
ssd_burst_usage	Usage of the burst portion of the SSD resource.
ssd_burst_cost	Cost of the burst portion of the SSD resource.
ssd_total_cost	Total cost of the SSD resource.
ssd_total_usage	Total usage of the SSD resource in GB·h.
archive_reserve_usage	Usage of the reserved portion of the archived resource in GB·h.
archive_reserve_cost	Cost of the reserved portion of the archived resource.
archive_burst_usage	Usage of the burst portion of the archived resource in GB·h.
archive_burst_cost	Cost of the burst portion of the archived resource.
archive_total_usage	Total Usage of the archived resource in GB·h.
archive_total_cost	Total Cost of the archived resource.
bandwidth_usage	Usage of the bandwidth in GB.
bandwidth_total_cost	Total cost of the bandwidth.
bandwidth_burst_cost	Total cost of the burst portion of bandwidth.
bandwidth_reserve_cost	Total cost of the reserve portion of bandwidth.
total_cost	Total cost of the resource.
name	Entity Name.
is_deleted	Whether or not resource has been deleted.
deleted_date	Date that resource was deleted on.

Parameters:

orgUuid - String org uuid

billingReportSpec - BillingReportRequest billing report

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:

TaskResponse asynchronous task

generateVmInventoryReport

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

Generate the vm inventory report for a given organization. Only available as report type of 'csv'.

Parameters:

orgUuid - String org 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:

TaskResponse asynchronous task

getContinuityProtectionReports

@GET
 @Path(value="/{orgUuid}/continuity-protection-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getContinuityProtectionReports(@PathParam(value="orgUuid")
                                                                                                                                                                                   String orgUuid,
                                                                                                                                                                                   @QueryParam(value="format")
                                                                                                                                                                                   ReportFormat reportFormat,
                                                                                                                                                                                   @QueryParam(value="latest")
                                                                                                                                                                                   Boolean latest)

Get the continuity protection reports for the organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• CSV

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization UUID

Returns:

list of reports available for download

getDisasterRecoveryAdminReports

@GET
 @Path(value="/{orgUuid}/dr-admin-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getDisasterRecoveryAdminReports(@PathParam(value="orgUuid")
                                                                                                                                                                       String orgUuid,
                                                                                                                                                                       @QueryParam(value="format")
                                                                                                                                                                       ReportFormat reportFormat,
                                                                                                                                                                       @QueryParam(value="latest")
                                                                                                                                                                       Boolean latest)

Get the DR admin reports for the organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• CSV

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization UUID

Returns:

list of reports available for download

getBillingReports

@GET
 @Path(value="/{orgUuid}/billing-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getBillingReports(@PathParam(value="orgUuid")
                                                                                                                                                        String orgUuid,
                                                                                                                                                        @QueryParam(value="format")
                                                                                                                                                        ReportFormat reportFormat,
                                                                                                                                                        @QueryParam(value="latest")
                                                                                                                                                        Boolean latest)

Get the billing reports for the organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• CSV

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization UUID

Returns:

list of reports available for download

getVmInventoryReports

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

Get the VM inventory reports for the organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML
• CSV

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization UUID

Returns:

list of reports available for download

getSupportRequestReports

@GET
 @Path(value="/{orgUuid}/support-request-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getSupportRequestReports(@PathParam(value="orgUuid")
                                                                                                                                                                       String orgUuid,
                                                                                                                                                                       @QueryParam(value="format")
                                                                                                                                                                       ReportFormat reportFormat,
                                                                                                                                                                       @QueryParam(value="latest")
                                                                                                                                                                       Boolean latest)

Get the support request reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getCloudEventReports

@GET
 @Path(value="/{orgUuid}/cloud-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getCloudEventReports(@PathParam(value="orgUuid")
                                                                                                                                                               String orgUuid,
                                                                                                                                                               @QueryParam(value="format")
                                                                                                                                                               ReportFormat reportFormat,
                                                                                                                                                               @QueryParam(value="latest")
                                                                                                                                                               Boolean latest)

Get the cloud event history reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getLoginEventReports

@GET
 @Path(value="/{orgUuid}/login-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getLoginEventReports(@PathParam(value="orgUuid")
                                                                                                                                                               String orgUuid,
                                                                                                                                                               @QueryParam(value="format")
                                                                                                                                                               ReportFormat reportFormat,
                                                                                                                                                               @QueryParam(value="latest")
                                                                                                                                                               Boolean latest)

Get the login event history reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getVMEncryptionReports

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

Get the VM encryption reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getHIPAAReports

@GET
 @Path(value="/{orgUuid}/hipaa-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getHIPAAReports(@PathParam(value="orgUuid")
                                                                                                                                                    String orgUuid,
                                                                                                                                                    @QueryParam(value="format")
                                                                                                                                                    ReportFormat reportFormat,
                                                                                                                                                    @QueryParam(value="latest")
                                                                                                                                                    Boolean latest)

Get the HIPAA reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getWebReputationEventReports

@GET
 @Path(value="/{orgUuid}/web-reputation-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getWebReputationEventReports(@PathParam(value="orgUuid")
                                                                                                                                                                                String orgUuid,
                                                                                                                                                                                @QueryParam(value="format")
                                                                                                                                                                                ReportFormat reportFormat,
                                                                                                                                                                                @QueryParam(value="latest")
                                                                                                                                                                                Boolean latest)

Get the web reputation event reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getDPIEventReports

@GET
 @Path(value="/{orgUuid}/dpi-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getDPIEventReports(@PathParam(value="orgUuid")
                                                                                                                                                           String orgUuid,
                                                                                                                                                           @QueryParam(value="format")
                                                                                                                                                           ReportFormat reportFormat,
                                                                                                                                                           @QueryParam(value="latest")
                                                                                                                                                           Boolean latest)

Get the DPI event reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getIntegrityEventReports

@GET
 @Path(value="/{orgUuid}/integrity-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getIntegrityEventReports(@PathParam(value="orgUuid")
                                                                                                                                                                       String orgUuid,
                                                                                                                                                                       @QueryParam(value="format")
                                                                                                                                                                       ReportFormat reportFormat,
                                                                                                                                                                       @QueryParam(value="latest")
                                                                                                                                                                       Boolean latest)

Get the integrity event reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getFirewallEventReports

@GET
 @Path(value="/{orgUuid}/firewall-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getFirewallEventReports(@PathParam(value="orgUuid")
                                                                                                                                                                     String orgUuid,
                                                                                                                                                                     @QueryParam(value="format")
                                                                                                                                                                     ReportFormat reportFormat,
                                                                                                                                                                     @QueryParam(value="latest")
                                                                                                                                                                     Boolean latest)

Get the firewall event reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getLogInspectionEventReports

@GET
 @Path(value="/{orgUuid}/log-inspection-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getLogInspectionEventReports(@PathParam(value="orgUuid")
                                                                                                                                                                                String orgUuid,
                                                                                                                                                                                @QueryParam(value="format")
                                                                                                                                                                                ReportFormat reportFormat,
                                                                                                                                                                                @QueryParam(value="latest")
                                                                                                                                                                                Boolean latest)

Get the log inspection reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getAntimalwareEventReports

@GET
 @Path(value="/{orgUuid}/anti-malware-event-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getAntimalwareEventReports(@PathParam(value="orgUuid")
                                                                                                                                                                            String orgUuid,
                                                                                                                                                                            @QueryParam(value="format")
                                                                                                                                                                            ReportFormat reportFormat,
                                                                                                                                                                            @QueryParam(value="latest")
                                                                                                                                                                            Boolean latest)

Get the anti-malware reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getVulnerabilityReports

@GET
 @Path(value="/{orgUuid}/vulnerability-reports")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ReportHeaderListResponse getVulnerabilityReports(@PathParam(value="orgUuid")
                                                                                                                                                                    String orgUuid,
                                                                                                                                                                    @QueryParam(value="format")
                                                                                                                                                                    ReportFormat reportFormat,
                                                                                                                                                                    @QueryParam(value="latest")
                                                                                                                                                                    Boolean latest)

Get the vulnerability reports available for download for the given organization. The endpoint also supports filtering by report format, using the query param "format". Report formats available to filter on include:

• PDF
• HTML

If the query param 'latest' is supplied only the latest report will be returned.

Parameters:

orgUuid - organization uuid

Returns:

list of reports available for download

getComplianceOverTimeSerie

@GET
 @Path(value="/{orgUuid}/compliance-over-time")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
ComplianceOverTimeResponse getComplianceOverTimeSerie(@PathParam(value="orgUuid")
                                                                                                                                                                        String orgUuid,
                                                                                                                                                                        @QueryParam(value="type")
                                                                                                                                                                        ComplianceOverTimeResponse.SerieType type,
                                                                                                                                                                        @QueryParam(value="start")
                                                                                                                                                                        Long start,
                                                                                                                                                                        @QueryParam(value="end")
                                                                                                                                                                        Long end,
                                                                                                                                                                        @QueryParam(value="limit")
                                                                                                                                                                        Integer limit)

Get the compliance over time serie for the given organization and serie name. The default timeframe is the past month if no start and end query params are provided. The following serie names are valid:

• ANTI_MALWARE
• VULNERABILITY
• LOG_INSPECTION
• FIREWALL

Parameters:

orgUuid - organization uuid

type - type of the compliance over time serie

start - start date (defaults to one month prior to end param)

end - end date (defaults to current time if not provided)

limit - limit on numer of samples to return (defaults to 60)

Returns:

the compliance over time serie

getVulnerabilityOverTimeSerie

@GET
 @Path(value="/{orgUuid}/vulnerability-over-time")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
VulnerabilityOverTimeResponse getVulnerabilityOverTimeSerie(@PathParam(value="orgUuid")
                                                                                                                                                                                 String orgUuid,
                                                                                                                                                                                 @QueryParam(value="start")
                                                                                                                                                                                 Long start,
                                                                                                                                                                                 @QueryParam(value="end")
                                                                                                                                                                                 Long end,
                                                                                                                                                                                 @QueryParam(value="limit")
                                                                                                                                                                                 Integer limit)

Get the vulnerability over time serie for the given organization and date range. The default timeframe is the past month if no start and end query params are provided.

Parameters:

orgUuid - organization uuid

start - start date (defaults to Jan 1, 1970)

end - end date (defaults to current time if not provided)

limit - limit on numer of samples to return (defaults to 730)

Returns:

the vulnerability over time serie

getAntimalwareOverTimeSerie

@GET
 @Path(value="/{orgUuid}/anti-malware-over-time")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
AntimalwareOverTimeResponse getAntimalwareOverTimeSerie(@PathParam(value="orgUuid")
                                                                                                                                                                            String orgUuid,
                                                                                                                                                                            @QueryParam(value="start")
                                                                                                                                                                            Long start,
                                                                                                                                                                            @QueryParam(value="end")
                                                                                                                                                                            Long end,
                                                                                                                                                                            @QueryParam(value="limit")
                                                                                                                                                                            Integer limit)

Get the antimalware over time serie for the given organization and date range. The default timeframe is the past month if no start and end query params are provided.

Parameters:

orgUuid - organization uuid

start - start date (defaults to Jan 1, 1970)

end - end date (defaults to current time if not provided)

limit - limit on numer of samples to return (defaults to 730)

Returns:

the antimalware over time serie

getLogInspectionOverTimeSerie

@GET
 @Path(value="/{orgUuid}/log-inspection-over-time")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
LogInspectionOverTimeResponse getLogInspectionOverTimeSerie(@PathParam(value="orgUuid")
                                                                                                                                                                                  String orgUuid,
                                                                                                                                                                                  @QueryParam(value="start")
                                                                                                                                                                                  Long start,
                                                                                                                                                                                  @QueryParam(value="end")
                                                                                                                                                                                  Long end,
                                                                                                                                                                                  @QueryParam(value="limit")
                                                                                                                                                                                  Integer limit)

Get the log inspection over time serie for the given organization and date range. The default timeframe is the past month if no start and end query params are provided.

Parameters:

orgUuid - organization uuid

start - start date (defaults to Jan 1, 1970)

end - end date (defaults to current time if not provided)

limit - limit on numer of samples to return (defaults to 730)

Returns:

the log inspection over time serie

getFirewallOverTimeSerie

@GET
 @Path(value="/{orgUuid}/firewall-over-time")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
FirewallOverTimeResponse getFirewallOverTimeSerie(@PathParam(value="orgUuid")
                                                                                                                                                                  String orgUuid,
                                                                                                                                                                  @QueryParam(value="start")
                                                                                                                                                                  Long start,
                                                                                                                                                                  @QueryParam(value="end")
                                                                                                                                                                  Long end,
                                                                                                                                                                  @QueryParam(value="limit")
                                                                                                                                                                  Integer limit)

Get the firewall over time serie for the given organization and date range. The default timeframe is the past month if no start and end query params are provided.

Parameters:

orgUuid - organization uuid

start - start date (defaults to Jan 1, 1970)

end - end date (defaults to current time if not provided)

limit - limit on numer of samples to return (defaults to 730)

Returns:

the firewall over time serie

getCount

@GET
 @Path(value="/{orgUuid}/report-count")
 @Produces(value="application/vnd.ilandcloud.api.v1.0+json")
EventCountResponse getCount(@PathParam(value="orgUuid")
                                                                                                                                      String orgUuid,
                                                                                                                                      @QueryParam(value="reportType")
                                                                                                                                      String reportType,
                                                                                                                                      @QueryParam(value="start")
                                                                                                                                      Long start,
                                                                                                                                      @QueryParam(value="end")
                                                                                                                                      Long end)

Get the number of events for the given organization, date range, and report type. Date range limited to 24 hours. If dates not specified then range is set to last 24 hours. Report types available to filter on include:

• anti_malware
• log_inspection
• login_event
• firewall_event
• integrity_event
• dpi_event
• web_reputation_event
• ecs_event_history

Parameters:

orgUuid - organization uuid

reportType - type of report to filter on

start - start date (defaults to yesterday)

end - end date (defaults to today)