All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.ovirt.engine.sdk4.services.NetworkService Maven / Gradle / Ivy

There is a newer version: 4.5.1
Show newest version
/*
Copyright (c) 2015 Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

package org.ovirt.engine.sdk4.services;

import java.io.IOException;
import org.ovirt.engine.sdk4.Request;
import org.ovirt.engine.sdk4.Response;
import org.ovirt.engine.sdk4.Service;
import org.ovirt.engine.sdk4.builders.NetworkBuilder;
import org.ovirt.engine.sdk4.types.Network;

/**
 * A service managing a network
 */
public interface NetworkService extends Service {
    /**
     * Gets a logical network.
     * 
     * For example:
     * 
     * [source]
     * ----
     * GET /ovirt-engine/api/networks/123
     * ----
     * 
     * Will respond:
     * 
     * [source,xml]
     * ----
     * 
     *   ovirtmgmt
     *   Default Management Network
     *   
     *   
     *   
     *   0
     *   false
     *   
     *     vm
     *   
     *   
     * 
     * ----
     */
    public interface GetRequest extends Request {
    }
    
    /**
     * Gets a logical network.
     * 
     * For example:
     * 
     * [source]
     * ----
     * GET /ovirt-engine/api/networks/123
     * ----
     * 
     * Will respond:
     * 
     * [source,xml]
     * ----
     * 
     *   ovirtmgmt
     *   Default Management Network
     *   
     *   
     *   
     *   0
     *   false
     *   
     *     vm
     *   
     *   
     * 
     * ----
     */
    public interface GetResponse extends Response {
        Network network();
    }
    
    /**
     * Gets a logical network.
     * 
     * For example:
     * 
     * [source]
     * ----
     * GET /ovirt-engine/api/networks/123
     * ----
     * 
     * Will respond:
     * 
     * [source,xml]
     * ----
     * 
     *   ovirtmgmt
     *   Default Management Network
     *   
     *   
     *   
     *   0
     *   false
     *   
     *     vm
     *   
     *   
     * 
     * ----
     */
    GetRequest get();
    
    /**
     * Removes a logical network, or the association of a logical network to a data center.
     * 
     * For example, to remove the logical network `123` send a request like this:
     * 
     * [source]
     * ----
     * DELETE /ovirt-engine/api/networks/123
     * ----
     * 
     * Each network is bound exactly to one data center. So if we disassociate network with data center it has the same
     * result as if we would just remove that network. However it might be more specific to say we're removing network
     * `456` of data center `123`.
     * 
     * For example, to remove the association of network `456` to data center `123` send a request like this:
     * 
     * [source]
     * ----
     * DELETE /ovirt-engine/api/datacenters/123/networks/456
     * ----
     */
    public interface RemoveRequest extends Request {
        /**
         * Indicates if the remove should be performed asynchronously.
         */
        RemoveRequest async(Boolean async);
    }
    
    /**
     * Removes a logical network, or the association of a logical network to a data center.
     * 
     * For example, to remove the logical network `123` send a request like this:
     * 
     * [source]
     * ----
     * DELETE /ovirt-engine/api/networks/123
     * ----
     * 
     * Each network is bound exactly to one data center. So if we disassociate network with data center it has the same
     * result as if we would just remove that network. However it might be more specific to say we're removing network
     * `456` of data center `123`.
     * 
     * For example, to remove the association of network `456` to data center `123` send a request like this:
     * 
     * [source]
     * ----
     * DELETE /ovirt-engine/api/datacenters/123/networks/456
     * ----
     */
    public interface RemoveResponse extends Response {
    }
    
    /**
     * Removes a logical network, or the association of a logical network to a data center.
     * 
     * For example, to remove the logical network `123` send a request like this:
     * 
     * [source]
     * ----
     * DELETE /ovirt-engine/api/networks/123
     * ----
     * 
     * Each network is bound exactly to one data center. So if we disassociate network with data center it has the same
     * result as if we would just remove that network. However it might be more specific to say we're removing network
     * `456` of data center `123`.
     * 
     * For example, to remove the association of network `456` to data center `123` send a request like this:
     * 
     * [source]
     * ----
     * DELETE /ovirt-engine/api/datacenters/123/networks/456
     * ----
     */
    RemoveRequest remove();
    
    /**
     * Updates a logical network.
     * 
     * The `name`, `description`, `ip`, `vlan`, `stp` and `display` attributes can be updated.
     * 
     * For example, to update the description of the logical network `123` send a request like this:
     * 
     * [source]
     * ----
     * PUT /ovirt-engine/api/networks/123
     * ----
     * 
     * With a request body like this:
     * 
     * [source,xml]
     * ----
     * 
     *   My updated description
     * 
     * ----
     * 
     * 
     * The maximum transmission unit of a network is set using a PUT request to
     * specify the integer value of the `mtu` attribute.
     * 
     * For example, to set the maximum transmission unit send a request like this:
     * 
     * [source]
     * ----
     * PUT /ovirt-engine/api/datacenters/123/networks/456
     * ----
     * 
     * With a request body like this:
     * 
     * [source,xml]
     * ----
     * 
     *   1500
     * 
     * ----
     */
    public interface UpdateRequest extends Request {
        /**
         * Indicates if the update should be performed asynchronously.
         */
        UpdateRequest async(Boolean async);
        UpdateRequest network(Network network);
        UpdateRequest network(NetworkBuilder network);
    }
    
    /**
     * Updates a logical network.
     * 
     * The `name`, `description`, `ip`, `vlan`, `stp` and `display` attributes can be updated.
     * 
     * For example, to update the description of the logical network `123` send a request like this:
     * 
     * [source]
     * ----
     * PUT /ovirt-engine/api/networks/123
     * ----
     * 
     * With a request body like this:
     * 
     * [source,xml]
     * ----
     * 
     *   My updated description
     * 
     * ----
     * 
     * 
     * The maximum transmission unit of a network is set using a PUT request to
     * specify the integer value of the `mtu` attribute.
     * 
     * For example, to set the maximum transmission unit send a request like this:
     * 
     * [source]
     * ----
     * PUT /ovirt-engine/api/datacenters/123/networks/456
     * ----
     * 
     * With a request body like this:
     * 
     * [source,xml]
     * ----
     * 
     *   1500
     * 
     * ----
     */
    public interface UpdateResponse extends Response {
        Network network();
    }
    
    /**
     * Updates a logical network.
     * 
     * The `name`, `description`, `ip`, `vlan`, `stp` and `display` attributes can be updated.
     * 
     * For example, to update the description of the logical network `123` send a request like this:
     * 
     * [source]
     * ----
     * PUT /ovirt-engine/api/networks/123
     * ----
     * 
     * With a request body like this:
     * 
     * [source,xml]
     * ----
     * 
     *   My updated description
     * 
     * ----
     * 
     * 
     * The maximum transmission unit of a network is set using a PUT request to
     * specify the integer value of the `mtu` attribute.
     * 
     * For example, to set the maximum transmission unit send a request like this:
     * 
     * [source]
     * ----
     * PUT /ovirt-engine/api/datacenters/123/networks/456
     * ----
     * 
     * With a request body like this:
     * 
     * [source,xml]
     * ----
     * 
     *   1500
     * 
     * ----
     */
    UpdateRequest update();
    
    /**
     * Reference to the service that manages the network labels assigned to this network.
     */
    NetworkLabelsService networkLabelsService();
    /**
     * Reference to the service that manages the permissions assigned to this network.
     */
    AssignedPermissionsService permissionsService();
    /**
     * Reference to the service that manages the vNIC profiles assigned to this network.
     */
    AssignedVnicProfilesService vnicProfilesService();
    /**
     * Service locator method, returns individual service on which the URI is dispatched.
     */
    Service service(String path);
}





© 2015 - 2024 Weber Informatics LLC | Privacy Policy