com.emc.vipr.client.core

Class ObjectVirtualPools

java.lang.Object

com.emc.vipr.client.core.AbstractResources<T>

com.emc.vipr.client.core.AbstractBulkResources<T>

com.emc.vipr.client.core.AbstractCoreBulkResources<ObjectVirtualPoolRestRep>

com.emc.vipr.client.core.ObjectVirtualPools

All Implemented Interfaces:

ACLResources, BulkResources<ObjectVirtualPoolRestRep>, QuotaResources, Resources<ObjectVirtualPoolRestRep>, TopLevelResources<ObjectVirtualPoolRestRep>

public class ObjectVirtualPools
extends AbstractCoreBulkResources<ObjectVirtualPoolRestRep>
implements TopLevelResources<ObjectVirtualPoolRestRep>, ACLResources, QuotaResources

Object Virtual Pools resources.

Base URL: /object/vpools

Constructor Summary

Constructors

Constructor and Description
ObjectVirtualPools(ViPRCoreClient parent, RestClient client)

Method Summary

Modifier and Type	Method and Description
ObjectVirtualPoolRestRep	assignStoragePools(java.net.URI id, VirtualPoolPoolUpdateParam input) Manually updates storage pool assignments for a given object virtual pool.
ObjectVirtualPoolRestRep	create(ObjectVirtualPoolParam input) Creates a object virtual pool.
void	deactivate(ObjectVirtualPoolRestRep pool)
void	deactivate(java.net.URI id) Deactivates a object virtual pool.
java.util.List<ACLEntry>	getACLs(java.net.URI id) Gets the ACL entries for a given resource by ID.
java.util.List<ObjectVirtualPoolRestRep>	getAll() Gets a list of all object virtual pools.
java.util.List<ObjectVirtualPoolRestRep>	getAll(ResourceFilter<ObjectVirtualPoolRestRep> filter) Gets a list of all object virtual pools, optionally filtering the results.
java.util.List<ObjectVirtualPoolRestRep>	getByTenant(java.net.URI tenantId)
java.util.List<ObjectVirtualPoolRestRep>	getByTenant(java.net.URI tenantId, ResourceFilter<ObjectVirtualPoolRestRep> filter)
java.util.List<ObjectVirtualPoolRestRep>	getByVirtualArray(java.net.URI varrayId) Gets the storage pools that are associated with the given block virtual pool.
java.util.List<ObjectVirtualPoolRestRep>	getByVirtualArray(java.net.URI varrayId, ResourceFilter<ObjectVirtualPoolRestRep> filter) Gets the storage pools that are associated with the given block virtual pool.
java.util.List<ObjectVirtualPoolRestRep>	getByVirtualArray(java.net.URI varrayId, java.net.URI tenantId, ResourceFilter<ObjectVirtualPoolRestRep> filter)
java.util.List<ObjectVirtualPoolRestRep>	getByVirtualArrayAndTenant(java.net.URI varrayId, java.net.URI tenantId) Gets the storage pools that are associated with the given block virtual pool and tenant.
CapacityResponse	getCapacityOnVirtualArray(java.net.URI id, java.net.URI virtualArrayId) Get the capacity of the object virtual pool on the given virtual array.
java.util.List<StoragePoolRestRep>	getMatchingStoragePools(ObjectVirtualPoolParam input) Gets all storage pools that would match the given object virtual pool configuration.
QuotaInfo	getQuota(java.net.URI id) Gets the quota information for a given resource by ID.
java.util.List<StoragePoolRestRep>	getStoragePools(java.net.URI id) Gets the list of storage pools for the given object virtual pool by ID.
java.util.List<NamedRelatedVirtualPoolRep>	list() Lists all object virtual pools.
java.util.List<NamedRelatedVirtualPoolRep>	listByTenant(java.net.URI tenantId) Lists all virtual pools of specific tenant
java.util.List<NamedRelatedVirtualPoolRep>	listByVDC(java.lang.String shortVdcId) Lists all virtual pools in a virtual data center
java.util.List<NamedRelatedVirtualPoolRep>	listByVirtualArray(java.net.URI varrayId) Lists the virtual pools that are associated with the given virtual array.
java.util.List<NamedRelatedVirtualPoolRep>	listByVirtualArrayAndTenant(java.net.URI varrayId, java.net.URI tenantId)
java.util.List<NamedRelatedResourceRep>	listMatchingStoragePools(ObjectVirtualPoolParam input) Lists all storage pools that would match the given object virtual pool configuration.
java.util.List<NamedRelatedResourceRep>	listStoragePools(java.net.URI id) Lists the storage pools for the given object virtual pool by ID.
java.util.List<NamedRelatedResourceRep>	refreshMatchingStoragePools(java.net.URI id) Refreshes the storage pools that match the given object virtual pool.
ObjectVirtualPoolRestRep	update(java.net.URI id, ObjectVirtualPoolUpdateParam input) Updates an object virtual pool.
java.util.List<ACLEntry>	updateACLs(java.net.URI id, ACLAssignmentChanges aclChanges) Updates the ACL entries for a given resource by ID.
QuotaInfo	updateQuota(java.net.URI id, QuotaUpdateParam quota) Updates the quota information for a given resource by ID.
ObjectVirtualPools	withInactive(boolean inactive) Configures the fetch operations to include inactive resources.
ObjectVirtualPools	withInternal(boolean internal) Configures the fetch operations to include internal resources.

Methods inherited from class com.emc.vipr.client.core.AbstractBulkResources

getByIds, getByRefs, listBulkIds

Methods inherited from class com.emc.vipr.client.core.AbstractResources

addTags, get, get, getByIds, getByRefs, getTags, performSearch, performSearchBy, removeTags, search, updateTags

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.emc.vipr.client.core.BulkResources

getByIds, getByRefs

Methods inherited from interface com.emc.vipr.client.core.Resources

addTags, get, get, getTags, removeTags, search, updateTags

Constructor Detail

ObjectVirtualPools

public ObjectVirtualPools(ViPRCoreClient parent,
                          RestClient client)

Method Detail

withInactive

public ObjectVirtualPools withInactive(boolean inactive)

Description copied from class: AbstractResources

Configures the fetch operations to include inactive resources.

Overrides:

withInactive in class AbstractResources<ObjectVirtualPoolRestRep>

Parameters:

inactive - whether to include inactive resources.

Returns:

this AbstractResources.

withInternal

public ObjectVirtualPools withInternal(boolean internal)

Description copied from class: AbstractResources

Configures the fetch operations to include internal resources.

Overrides:

withInternal in class AbstractResources<ObjectVirtualPoolRestRep>

Parameters:

internal - whether to include internal resources.

Returns:

this AbstractResources.

list

public java.util.List<NamedRelatedVirtualPoolRep> list()

Lists all object virtual pools.

API Call: GET /object/vpools

Specified by:

list in interface TopLevelResources<ObjectVirtualPoolRestRep>

Returns:

the list of all object virtual pool references.

listByVDC

public java.util.List<NamedRelatedVirtualPoolRep> listByVDC(java.lang.String shortVdcId)

Lists all virtual pools in a virtual data center

API Call: GET /object/vpools

Returns:

the list of virtual pool references in a virtual data center

listByTenant

public java.util.List<NamedRelatedVirtualPoolRep> listByTenant(java.net.URI tenantId)

Lists all virtual pools of specific tenant

API Call: GET /object/vpools

Returns:

the list of virtual pool references of specific tenant

getByTenant

public java.util.List<ObjectVirtualPoolRestRep> getByTenant(java.net.URI tenantId)

getByTenant

public java.util.List<ObjectVirtualPoolRestRep> getByTenant(java.net.URI tenantId,
                                                            ResourceFilter<ObjectVirtualPoolRestRep> filter)

getAll

public java.util.List<ObjectVirtualPoolRestRep> getAll()

Gets a list of all object virtual pools.

This is a convenience method for: getByRefs(list())

Specified by:

getAll in interface TopLevelResources<ObjectVirtualPoolRestRep>

Returns:

the list of object virtual pools.

See Also:

TopLevelResources.list(), Resources.getByRefs(java.util.Collection)

getAll

public java.util.List<ObjectVirtualPoolRestRep> getAll(ResourceFilter<ObjectVirtualPoolRestRep> filter)

Gets a list of all object virtual pools, optionally filtering the results.

This is a convenience method for: getByRefs(list(), filter)

Specified by:

getAll in interface TopLevelResources<ObjectVirtualPoolRestRep>

Parameters:

filter - the resource filter to apply to the results as they are returned (optional).

Returns:

the list of object virtual pools.

See Also:

TopLevelResources.list(), Resources.getByRefs(java.util.Collection, ResourceFilter)

create

public ObjectVirtualPoolRestRep create(ObjectVirtualPoolParam input)

Creates a object virtual pool.

API Call: POST /object/vpools

Parameters:

input - the virtual pool configuration.

Returns:

the newly created object virtual pool.

update

public ObjectVirtualPoolRestRep update(java.net.URI id,
                                       ObjectVirtualPoolUpdateParam input)

Updates an object virtual pool.

API Call: PUT /object/vpools/{id}

Parameters:

id - the ID of the object virtual pool to update.

input -

Returns:

deactivate

public void deactivate(java.net.URI id)

Deactivates a object virtual pool.

API Call: POST /object/vpools/{id}/deactivate

Parameters:

id - the ID of the object virtual pool.

deactivate

public void deactivate(ObjectVirtualPoolRestRep pool)

listByVirtualArray

public java.util.List<NamedRelatedVirtualPoolRep> listByVirtualArray(java.net.URI varrayId)

Lists the virtual pools that are associated with the given virtual array.

API Call: GET /vdc/varrays/{id}/vpools

Parameters:

varrayId - the ID of the virtual array.

Returns:

the list of virtual pool references.

listByVirtualArrayAndTenant

public java.util.List<NamedRelatedVirtualPoolRep> listByVirtualArrayAndTenant(java.net.URI varrayId,
                                                                              java.net.URI tenantId)

getByVirtualArray

public java.util.List<ObjectVirtualPoolRestRep> getByVirtualArray(java.net.URI varrayId)

Gets the storage pools that are associated with the given block virtual pool. Convenience method for calling getByRefs(listByVirtualArray(varrayId)).

Parameters:

varrayId - the ID of the virtual array.

Returns:

the list of virtual pools.

See Also:

listByVirtualArray(URI), AbstractResources.getByRefs(java.util.Collection)

getByVirtualArray

public java.util.List<ObjectVirtualPoolRestRep> getByVirtualArray(java.net.URI varrayId,
                                                                  ResourceFilter<ObjectVirtualPoolRestRep> filter)

Gets the storage pools that are associated with the given block virtual pool. Convenience method for calling getByRefs(listByVirtualArray(varrayId)).

Parameters:

varrayId - the ID of the virtual array.

filter - the resource filter to apply to the results as they are returned (optional).

Returns:

the list of virtual pools.

See Also:

listByVirtualArray(URI), AbstractResources.getByRefs(java.util.Collection)

getByVirtualArray

public java.util.List<ObjectVirtualPoolRestRep> getByVirtualArray(java.net.URI varrayId,
                                                                  java.net.URI tenantId,
                                                                  ResourceFilter<ObjectVirtualPoolRestRep> filter)

getByVirtualArrayAndTenant

public java.util.List<ObjectVirtualPoolRestRep> getByVirtualArrayAndTenant(java.net.URI varrayId,
                                                                           java.net.URI tenantId)

Gets the storage pools that are associated with the given block virtual pool and tenant.

Parameters:

varrayId - the ID of the virtual array.

tenantId - the ID of tenant

Returns:

the list of virtual pools.

See Also:

listByVirtualArray(URI), AbstractResources.getByRefs(java.util.Collection)

getACLs

public java.util.List<ACLEntry> getACLs(java.net.URI id)

Description copied from interface: ACLResources

Gets the ACL entries for a given resource by ID.

API Call: GET baseUrl/{id}/acl

Specified by:

getACLs in interface ACLResources

Parameters:

id - the resource ID.

Returns:

the list of ACL entries.

updateACLs

public java.util.List<ACLEntry> updateACLs(java.net.URI id,
                                           ACLAssignmentChanges aclChanges)

Description copied from interface: ACLResources

Updates the ACL entries for a given resource by ID.

API Call: PUT baseUrl/{id}/acl

Specified by:

updateACLs in interface ACLResources

Parameters:

id - the resource ID.

aclChanges - the ACL changes to perform (ACL entries to add/remove).

Returns:

the resulting list of ACL entries after performing the update.

getQuota

public QuotaInfo getQuota(java.net.URI id)

Description copied from interface: QuotaResources

Gets the quota information for a given resource by ID.

API Call: GET baseUrl/{id}/quota

Specified by:

getQuota in interface QuotaResources

Parameters:

id - the resource ID.

Returns:

the quota information.

updateQuota

public QuotaInfo updateQuota(java.net.URI id,
                             QuotaUpdateParam quota)

Description copied from interface: QuotaResources

Updates the quota information for a given resource by ID.

API Call: PUT baseUrl/{id}/quota

Specified by:

updateQuota in interface QuotaResources

Parameters:

id - the resource ID.

quota - the update to the quota.

Returns:

the updated quota information after applying the update.

getCapacityOnVirtualArray

public CapacityResponse getCapacityOnVirtualArray(java.net.URI id,
                                                  java.net.URI virtualArrayId)

Get the capacity of the object virtual pool on the given virtual array.

API Call: GET /object/vpools/{id}/varrays/{virtualArrayId}/capacity

Parameters:

id - the ID of the object virtual pool.

virtualArrayId - the virtual array.

Returns:

the capacity on the virtual array.

listStoragePools

public java.util.List<NamedRelatedResourceRep> listStoragePools(java.net.URI id)

Lists the storage pools for the given object virtual pool by ID.

API Call: GET /object/vpools/{id}/storage-pools

Parameters:

id - the ID of the object virtual pool.

Returns:

the list of storage pool references.

getStoragePools

public java.util.List<StoragePoolRestRep> getStoragePools(java.net.URI id)

Gets the list of storage pools for the given object virtual pool by ID. This is a convenience method for: getByRefs(listStoragePools(id)).

Parameters:

id - the ID of the object virtual pool.

Returns:

the list of storage pools.

listMatchingStoragePools

public java.util.List<NamedRelatedResourceRep> listMatchingStoragePools(ObjectVirtualPoolParam input)

Lists all storage pools that would match the given object virtual pool configuration.

API Call: POST /object/vpools/matching-pools

Parameters:

input - the object virtual pool configuration.

Returns:

the list of matching storage pool references.

getMatchingStoragePools

public java.util.List<StoragePoolRestRep> getMatchingStoragePools(ObjectVirtualPoolParam input)

Gets all storage pools that would match the given object virtual pool configuration.

Parameters:

input - the object virtual pool configuration.

Returns:

the list of matching storage pools.

refreshMatchingStoragePools

public java.util.List<NamedRelatedResourceRep> refreshMatchingStoragePools(java.net.URI id)

Refreshes the storage pools that match the given object virtual pool.

API Call: GET /object/vpools/{id}/refresh-matched-pools

Parameters:

id - the ID of the object virtual pool.

Returns:

the list of currently matching storage pool references.

assignStoragePools

public ObjectVirtualPoolRestRep assignStoragePools(java.net.URI id,
                                                   VirtualPoolPoolUpdateParam input)

Manually updates storage pool assignments for a given object virtual pool.

API Call: PUT /object/vpools/{id}/assign-matched-pools

Parameters:

id - the ID of the object virtual pool.

input - the configuration of the storage pool assignments.

Returns:

the updated object virtual pool.