Package com.oracle.bmc.apigateway.model

Class Api

  • @Generated(value="OracleSDKGenerator",
           comments="API Version: 20190501")
public final class Api
extends com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
    An API is simple container for an API Specification.

    For more information, see API Gateway Concepts.
    Note: Objects should always be created or deserialized using the Api.Builder. This model distinguishes fields that are null because they are unset from fields that are explicitly set to null. This is done in the setter methods of the Api.Builder, which maintain a set of all explicitly set fields called Api.Builder.__explicitlySet__. The hashCode() and equals(Object) methods are implemented to take the explicitly set fields into account. The constructor, on the other hand, does not take the explicitly set fields into account (since the constructor cannot distinguish explicit null from unset null).

    • Method Detail

      • builder

        public static Api.Builder builder()
        Create a new builder.

      • getId

        public String getId()
        The OCID of the resource.
        Returns:
        the value

      • getDisplayName

        public String getDisplayName()
        A user-friendly name.

        Does not have to be unique, and it’s changeable. Avoid entering confidential information.

        Example: My new resource

        Returns:
        the value

      • getCompartmentId

        public String getCompartmentId()
        The OCID of the compartment in which the resource is created.
        Returns:
        the value

      • getTimeCreated

        public Date getTimeCreated()
        The time this resource was created.

        An RFC3339 formatted datetime string.

        Returns:
        the value

      • getTimeUpdated

        public Date getTimeUpdated()
        The time this resource was last updated.

        An RFC3339 formatted datetime string.

        Returns:
        the value

      • getLifecycleState

        public Api.LifecycleState getLifecycleState()
        The current state of the API.
        Returns:
        the value

      • getLifecycleDetails

        public String getLifecycleDetails()
        A message describing the current lifecycleState in more detail.

        For ACTIVE state it describes if the document has been validated and the possible values are: - ‘New’ for just updated API Specifications - ‘Validating’ for a document which is being validated. - ‘Valid’ the document has been validated without any errors or warnings - ‘Warning’ the document has been validated and contains warnings - ‘Error’ the document has been validated and contains errors - ‘Failed’ the document validation failed - ‘Canceled’ the document validation was canceled

        For other states it may provide more details like actionable information.

        Returns:
        the value

      • getSpecificationType

        public String getSpecificationType()
        Type of API Specification file.
        Returns:
        the value

      • getValidationResults

        public List<ApiValidationResult> getValidationResults()
        Status of each feature available from the API.
        Returns:
        the value

      • getFreeformTags

        public Map<String,​String> getFreeformTags()
        Free-form tags for this resource.

        Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.

        Example: {"Department": "Finance"}

        Returns:
        the value

      • getDefinedTags

        public Map<String,​Map<String,​Object>> getDefinedTags()
        Defined tags for this resource.

        Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

        Example: {"Operations": {"CostCenter": "42"}}

        Returns:
        the value

      • toString

        public String toString()
        Overrides:
        toString in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel

      • toString

        public String toString​(boolean includeByteArrayContents)
        Return a string representation of the object.
        Parameters:
        includeByteArrayContents - true to include the full contents of byte arrays
        Returns:
        string representation

      • equals

        public boolean equals​(Object o)
        Overrides:
        equals in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel