com.softlayer.api.service.network.Backbone Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of softlayer-api-client Show documentation
Show all versions of softlayer-api-client Show documentation
API client for accessing the SoftLayer API
package com.softlayer.api.service.network;
import com.softlayer.api.ApiClient;
import com.softlayer.api.ResponseHandler;
import com.softlayer.api.annotation.ApiMethod;
import com.softlayer.api.annotation.ApiProperty;
import com.softlayer.api.annotation.ApiType;
import com.softlayer.api.service.Entity;
import com.softlayer.api.service.Location;
import com.softlayer.api.service.network.Component;
import java.util.List;
import java.util.concurrent.Future;
/**
* A SoftLayer_Network_Backbone represents a single backbone connection from SoftLayer to the public Internet, from the Internet to the SoftLayer private network, or a link that connects the private networks between SoftLayer's datacenters. The SoftLayer_Network_Backbone data type is a collection of data associated with one of those connections.
*
* @see SoftLayer_Network_Backbone
*/
@ApiType("SoftLayer_Network_Backbone")
public class Backbone extends Entity {
/**
* A backbone's status.
*/
@ApiProperty
protected String health;
public String getHealth() {
return health;
}
public void setHealth(String health) {
this.health = health;
}
/**
* Which of the SoftLayer datacenters a backbone is connected to.
*/
@ApiProperty
protected Location location;
public Location getLocation() {
return location;
}
public void setLocation(Location location) {
this.location = location;
}
/**
* A backbone's primary network component.
*/
@ApiProperty
protected Component networkComponent;
public Component getNetworkComponent() {
return networkComponent;
}
public void setNetworkComponent(Component networkComponent) {
this.networkComponent = networkComponent;
}
/**
* The numeric portion of the bandwidth capacity of a SoftLayer backbone. For instance, if a backbone is rated at "1 GigE" capacity then the capacity property of the backbone is 1.
*/
@ApiProperty(canBeNullOrNotSet = true)
protected Long capacity;
public Long getCapacity() {
return capacity;
}
public void setCapacity(Long capacity) {
capacitySpecified = true;
this.capacity = capacity;
}
protected boolean capacitySpecified;
public boolean isCapacitySpecified() {
return capacitySpecified;
}
public void unsetCapacity() {
capacity = null;
capacitySpecified = false;
}
/**
* The unit portion of the bandwidth capacity of a SoftLayer backbone. For instance, if a backbone is rated at "10 G" capacity then the capacityUnits property of the backbone is "G".
*/
@ApiProperty(canBeNullOrNotSet = true)
protected String capacityUnits;
public String getCapacityUnits() {
return capacityUnits;
}
public void setCapacityUnits(String capacityUnits) {
capacityUnitsSpecified = true;
this.capacityUnits = capacityUnits;
}
protected boolean capacityUnitsSpecified;
public boolean isCapacityUnitsSpecified() {
return capacityUnitsSpecified;
}
public void unsetCapacityUnits() {
capacityUnits = null;
capacityUnitsSpecified = false;
}
/**
* A backbone's internal identifier.
*/
@ApiProperty(canBeNullOrNotSet = true)
protected Long id;
public Long getId() {
return id;
}
public void setId(Long id) {
idSpecified = true;
this.id = id;
}
protected boolean idSpecified;
public boolean isIdSpecified() {
return idSpecified;
}
public void unsetId() {
id = null;
idSpecified = false;
}
/**
* A backbone's name. This is usually the name of the backbone's network provider followed by a number in case SoftLayer uses more than one backbone from a provider. Backbone provider numbers start with the number one and increment from there.
*/
@ApiProperty(canBeNullOrNotSet = true)
protected String name;
public String getName() {
return name;
}
public void setName(String name) {
nameSpecified = true;
this.name = name;
}
protected boolean nameSpecified;
public boolean isNameSpecified() {
return nameSpecified;
}
public void unsetName() {
name = null;
nameSpecified = false;
}
/**
* The internal identifier of the network component that backbone is connected to.
*/
@ApiProperty(canBeNullOrNotSet = true)
protected Long networkComponentId;
public Long getNetworkComponentId() {
return networkComponentId;
}
public void setNetworkComponentId(Long networkComponentId) {
networkComponentIdSpecified = true;
this.networkComponentId = networkComponentId;
}
protected boolean networkComponentIdSpecified;
public boolean isNetworkComponentIdSpecified() {
return networkComponentIdSpecified;
}
public void unsetNetworkComponentId() {
networkComponentId = null;
networkComponentIdSpecified = false;
}
/**
* Whether a SoftLayer backbone connects to the public Internet, to the private network, or connecting the private networks of SoftLayer's datacenters. Type is either the string "public", "private", or "private-interconnect".
*/
@ApiProperty(canBeNullOrNotSet = true)
protected String type;
public String getType() {
return type;
}
public void setType(String type) {
typeSpecified = true;
this.type = type;
}
protected boolean typeSpecified;
public boolean isTypeSpecified() {
return typeSpecified;
}
public void unsetType() {
type = null;
typeSpecified = false;
}
public Service asService(ApiClient client) {
return service(client, id);
}
public static Service service(ApiClient client) {
return client.createService(Service.class, null);
}
public static Service service(ApiClient client, Long id) {
return client.createService(Service.class, id == null ? null : id.toString());
}
/**
* A SoftLayer_Network_Backbone represents a single backbone connection from SoftLayer to the public Internet, from the Internet to the SoftLayer private network, or a link that connects the private networks between SoftLayer's datacenters. The SoftLayer_Network_Backbone service is unique in that it is not referenced by any of the other SoftLayer API services.
*
* @see SoftLayer_Network_Backbone
*/
@com.softlayer.api.annotation.ApiService("SoftLayer_Network_Backbone")
public static interface Service extends com.softlayer.api.Service {
public ServiceAsync asAsync();
public Mask withNewMask();
public Mask withMask();
public void setMask(Mask mask);
/**
* Retrieve a list of all SoftLayer backbone connections. Use this method if you need all backbones or don't know the id number of a specific backbone.
*
* @see SoftLayer_Network_Backbone::getAllBackbones
*/
@ApiMethod
public List getAllBackbones();
/**
* Retrieve a list of all SoftLayer backbone connections for a location name.
*
* @see SoftLayer_Network_Backbone::getBackbonesForLocationName
*/
@ApiMethod
public List getBackbonesForLocationName(String locationName);
/**
* [DEPRECATED] Retrieve a graph of a SoftLayer backbone's last 24 hours of activity. getGraphImage returns a PNG image measuring 827 pixels by 293 pixels.
*
* @see SoftLayer_Network_Backbone::getGraphImage
*/
@ApiMethod(instanceRequired = true)
public byte[] getGraphImage();
/**
* Retrieve an individual SoftLayer_Network_Backbone record. Use the getAllBackbones() method to retrieve a list of all SoftLayer network backbones.
*
* @see SoftLayer_Network_Backbone::getObject
*/
@ApiMethod(instanceRequired = true)
public Backbone getObject();
/**
* A backbone's status.
*
* @see SoftLayer_Network_Backbone::getHealth
*/
@ApiMethod(instanceRequired = true)
public String getHealth();
/**
* Which of the SoftLayer datacenters a backbone is connected to.
*
* @see SoftLayer_Network_Backbone::getLocation
*/
@ApiMethod(instanceRequired = true)
public Location getLocation();
/**
* A backbone's primary network component.
*
* @see SoftLayer_Network_Backbone::getNetworkComponent
*/
@ApiMethod(instanceRequired = true)
public Component getNetworkComponent();
}
public static interface ServiceAsync extends com.softlayer.api.ServiceAsync {
public Mask withNewMask();
public Mask withMask();
public void setMask(Mask mask);
/**
* Async version of {@link Service#getAllBackbones}
*/
public Future> getAllBackbones();
public Future> getAllBackbones(ResponseHandler> callback);
/**
* Async version of {@link Service#getBackbonesForLocationName}
*/
public Future> getBackbonesForLocationName(String locationName);
public Future> getBackbonesForLocationName(String locationName, ResponseHandler> callback);
/**
* Async version of {@link Service#getGraphImage}
*/
public Future getGraphImage();
public Future> getGraphImage(ResponseHandler callback);
/**
* Async version of {@link Service#getObject}
*/
public Future getObject();
public Future> getObject(ResponseHandler callback);
/**
* Async version of {@link Service#getHealth}
*/
public Future getHealth();
/**
* Async callback version of {@link Service#getHealth}
*/
public Future> getHealth(ResponseHandler callback);
/**
* Async version of {@link Service#getLocation}
*/
public Future getLocation();
/**
* Async callback version of {@link Service#getLocation}
*/
public Future> getLocation(ResponseHandler callback);
/**
* Async version of {@link Service#getNetworkComponent}
*/
public Future getNetworkComponent();
/**
* Async callback version of {@link Service#getNetworkComponent}
*/
public Future> getNetworkComponent(ResponseHandler callback);
}
public static class Mask extends com.softlayer.api.service.Entity.Mask {
public Mask health() {
withLocalProperty("health");
return this;
}
public com.softlayer.api.service.Location.Mask location() {
return withSubMask("location", com.softlayer.api.service.Location.Mask.class);
}
public Component.Mask networkComponent() {
return withSubMask("networkComponent", Component.Mask.class);
}
public Mask capacity() {
withLocalProperty("capacity");
return this;
}
public Mask capacityUnits() {
withLocalProperty("capacityUnits");
return this;
}
public Mask id() {
withLocalProperty("id");
return this;
}
public Mask name() {
withLocalProperty("name");
return this;
}
public Mask networkComponentId() {
withLocalProperty("networkComponentId");
return this;
}
public Mask type() {
withLocalProperty("type");
return this;
}
}
}