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

io.cloudslang.content.vmware.actions.vm.utils.GetOSDescriptors Maven / Gradle / Ivy

There is a newer version: 0.0.23
Show newest version
/*
 * (c) Copyright 2017 EntIT Software LLC, a Micro Focus company, L.P.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Apache License v2.0 which accompany this distribution.
 *
 * The Apache License is available 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 io.cloudslang.content.vmware.actions.vm.utils;

import com.hp.oo.sdk.content.annotations.Action;
import com.hp.oo.sdk.content.annotations.Output;
import com.hp.oo.sdk.content.annotations.Param;
import com.hp.oo.sdk.content.annotations.Response;
import com.hp.oo.sdk.content.plugin.ActionMetadata.MatchType;
import com.hp.oo.sdk.content.plugin.ActionMetadata.ResponseType;
import com.hp.oo.sdk.content.plugin.GlobalSessionObject;
import io.cloudslang.content.utils.OutputUtilities;
import io.cloudslang.content.vmware.connection.Connection;
import io.cloudslang.content.vmware.constants.Outputs;
import io.cloudslang.content.vmware.entities.VmInputs;
import io.cloudslang.content.vmware.entities.http.HttpInputs;
import io.cloudslang.content.vmware.services.VmService;

import java.util.Map;

import static io.cloudslang.content.constants.BooleanValues.FALSE;
import static io.cloudslang.content.constants.BooleanValues.TRUE;
import static io.cloudslang.content.vmware.constants.Inputs.*;
import static org.apache.commons.lang3.StringUtils.defaultIfEmpty;

/**
 * Created by Mihai Tusa.
 * 1/12/2016.
 */

public class GetOSDescriptors {
    /**
     * Connects to a data center to retrieve a list with all the guest operating system descriptors supported by the
     * host system.
     *
     * @param host           VMware host or IP - Example: "vc6.subdomain.example.com"
     * @param port           optional - the port to connect through - Examples: "443", "80" - Default: "443"
     * @param protocol       optional - the connection protocol - Valid: "http", "https" - Default: "https"
     * @param username       the VMware username use to connect
     * @param password       the password associated with "username" input
     * @param trustEveryone  optional - if "true" will allow connections from any host, if "false" the connection will be
     *                       allowed only using a valid vCenter certificate - Default: "true"
     *                       Check the: https://pubs.vmware.com/vsphere-50/index.jsp?topic=%2Fcom.vmware.wssdk.dsg.doc_50%2Fsdk_java_development.4.3.html
     *                       to see how to import a certificate into Java Keystore and
     *                       https://pubs.vmware.com/vsphere-50/index.jsp?topic=%2Fcom.vmware.wssdk.dsg.doc_50%2Fsdk_sg_server_certificate_Appendix.6.4.html
     *                       to see how to obtain a valid vCenter certificate
     * @param closeSession   Whether to use the flow session context to cache the Connection to the host or not. If set to
     *                       "false" it will close and remove any connection from the session context, otherwise the Connection
     *                       will be kept alive and not removed.
     *                       Valid values: "true", "false"
     *                       Default value: "true"
     * @param dataCenterName the data center name where the host system is - Example: 'DataCenter2'
     * @param hostname       the name of the target host to be queried to retrieve the supported guest OSes
     *                       - Example: 'host123.subdomain.example.com'
     * @param delimiter      the delimiter that will be used in response list - Default: ","
     * @return resultMap with String as key and value that contains returnCode of the operation, a list that contains all the
     * guest operating system descriptors supported by the host system or failure message and the exception if there is one
     */
    @Action(name = "Get OS Descriptors",
            outputs = {
                    @Output(Outputs.RETURN_CODE),
                    @Output(Outputs.RETURN_RESULT),
                    @Output(Outputs.EXCEPTION)
            },
            responses = {
                    @Response(text = Outputs.SUCCESS, field = Outputs.RETURN_CODE, value = Outputs.RETURN_CODE_SUCCESS,
                            matchType = MatchType.COMPARE_EQUAL, responseType = ResponseType.RESOLVED),
                    @Response(text = Outputs.FAILURE, field = Outputs.RETURN_CODE, value = Outputs.RETURN_CODE_FAILURE,
                            matchType = MatchType.COMPARE_EQUAL, responseType = ResponseType.ERROR, isOnFail = true)
            })
    public Map getOsDescriptors(@Param(value = HOST, required = true) String host,
                                                @Param(value = PORT) String port,
                                                @Param(value = PROTOCOL) String protocol,
                                                @Param(value = USERNAME, required = true) String username,
                                                @Param(value = PASSWORD, encrypted = true) String password,
                                                @Param(value = TRUST_EVERYONE) String trustEveryone,
                                                @Param(value = CLOSE_SESSION) String closeSession,

                                                @Param(value = DATA_CENTER_NAME, required = true) String dataCenterName,
                                                @Param(value = HOSTNAME, required = true) String hostname,

                                                @Param(value = DELIMITER) String delimiter,
                                                @Param(value = VMWARE_GLOBAL_SESSION_OBJECT) GlobalSessionObject> globalSessionObject) {

        try {
            final HttpInputs httpInputs = new HttpInputs.HttpInputsBuilder()
                    .withHost(host)
                    .withPort(port)
                    .withProtocol(protocol)
                    .withUsername(username)
                    .withPassword(password)
                    .withTrustEveryone(defaultIfEmpty(trustEveryone, FALSE))
                    .withCloseSession(defaultIfEmpty(closeSession, TRUE))
                    .withGlobalSessionObject(globalSessionObject)
                    .build();

            final VmInputs vmInputs = new VmInputs.VmInputsBuilder()
                    .withDataCenterName(dataCenterName)
                    .withHostname(hostname)
                    .build();

            return new VmService().getOsDescriptors(httpInputs, vmInputs, delimiter);
        } catch (Exception ex) {
            return OutputUtilities.getFailureResultsMap(ex);
        }
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy