Class ApiKey


  • @Generated(value="OracleSDKGenerator",
               comments="API Version: 20160918")
    public final class ApiKey
    extends com.oracle.bmc.http.client.internal.ExplicitlySetBmcModel
    A PEM-format RSA credential for securing requests to the Oracle Cloud Infrastructure REST API.

    Also known as an API signing key. Specifically, this is the public key from the key pair. The private key remains with the user calling the API. For information about generating a key pair in the required PEM format, see Required Keys and OCIDs.

    *Important:** This is **not** the SSH key for accessing compute instances.

    Each user can have a maximum of three API signing keys.

    For more information about user credentials, see [User Credentials](https://docs.oracle.com/iaas/Content/Identity/Concepts/usercredentials.htm).
    Note: Objects should always be created or deserialized using the ApiKey.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 ApiKey.Builder, which maintain a set of all explicitly set fields called ApiKey.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 ApiKey.Builder builder()
        Create a new builder.
      • getKeyId

        public String getKeyId()
        An Oracle-assigned identifier for the key, in this format: TENANCY_OCID/USER_OCID/KEY_FINGERPRINT.
        Returns:
        the value
      • getKeyValue

        public String getKeyValue()
        The key’s value.
        Returns:
        the value
      • getFingerprint

        public String getFingerprint()
        The key’s fingerprint (e.g., 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef).
        Returns:
        the value
      • getUserId

        public String getUserId()
        The OCID of the user the key belongs to.
        Returns:
        the value
      • getTimeCreated

        public Date getTimeCreated()
        Date and time the ApiKey object was created, in the format defined by RFC3339.

        Example: 2016-08-25T21:10:29.600Z

        Returns:
        the value
      • getLifecycleState

        public ApiKey.LifecycleState getLifecycleState()
        The API key’s current state.

        After creating an ApiKey object, make sure its lifecycleState changes from CREATING to ACTIVE before using it.

        Returns:
        the value
      • getInactiveStatus

        public Long getInactiveStatus()
        The detailed status of INACTIVE lifecycleState.
        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