@Generated(value="OracleSDKGenerator", comments="API Version: 20160918") public class ComputeAsyncClient extends BaseAsyncClient implements ComputeAsync
Async client implementation for Compute service.
There are two ways to use async client: 1. Use AsyncHandler: using AsyncHandler, if the response
to the call is an InputStream
, like getObject Api in object storage service,
developers need to process the stream in AsyncHandler, and not anywhere else, because the stream
will be closed right after the AsyncHandler is invoked.
2. Use Java Future: using Java Future, developers need to close the stream after they are done
with the Java Future.
Accessing the result should be done in a mutually exclusive manner, either through the Future or
the AsyncHandler, but not both. If the Future is used, the caller should pass in null as the
AsyncHandler. If the AsyncHandler is used, it is still safe to use the Future to determine
whether or not the request was completed via Future.isDone/isCancelled.
Please refer to
https://github.com/oracle/oci-java-sdk/blob/master/bmc-examples/src/main/java/ResteasyClientWithObjectStorageExample.java
Modifier and Type | Class and Description |
---|---|
static class |
ComputeAsyncClient.Builder
Builder class for this client.
|
Modifier and Type | Field and Description |
---|---|
String |
clientCommonLibraryVersion
Compatible SDK version, provided by the codegen.
|
Optional<String> |
minimumClientCommonLibraryVersionFromClient
Minimum compatible SDK version, maybe provided by the codegen.
|
static Service |
SERVICE
Service instance for Compute.
|
Constructor and Description |
---|
ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Deprecated.
Use the
builder instead. |
ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Deprecated.
Use the
builder instead. |
ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
ComputeAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.
Use the
builder instead. |
ComputeAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Deprecated.
Use the
builder instead. |
ComputeAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Deprecated.
Use the
builder instead. |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
close
public static final Service SERVICE
Service instance for Compute.
public final String clientCommonLibraryVersion
@Deprecated public ComputeAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)@Deprecated public ComputeAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
@Deprecated public ComputeAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
@Deprecated public ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
@Deprecated public ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
@Deprecated public ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
@Deprecated public ComputeAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ComputeAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
signingStrategyRequestSignerFactories
- ClientBuilderBase.signingStrategyRequestSignerFactories
public static ComputeAsyncClient.Builder builder()
Create a builder for this client.
public void setRegion(Region region)
ComputeAsync
Sets the region to call (ex, Region.US_PHOENIX_1).
Note, this will call setEndpoint
after resolving the
endpoint. If the service is not available in this region, however, an
IllegalArgumentException will be raised.
setRegion
in interface ComputeAsync
region
- The region of the service.public void setRegion(String regionId)
ComputeAsync
Sets the region to call (ex, ‘us-phoenix-1’).
Note, this will first try to map the region ID to a known Region and call setRegion
.
If no known Region could be determined, it will create an endpoint based on the default
endpoint format (Region.formatDefaultRegionEndpoint(Service, String)
and then call setEndpoint
.
setRegion
in interface ComputeAsync
regionId
- The public region ID.public Future<AcceptShieldedIntegrityPolicyResponse> acceptShieldedIntegrityPolicy(AcceptShieldedIntegrityPolicyRequest request, AsyncHandler<AcceptShieldedIntegrityPolicyRequest,AcceptShieldedIntegrityPolicyResponse> handler)
ComputeAsync
Accept the changes to the PCR values in the measured boot report.
acceptShieldedIntegrityPolicy
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<AddImageShapeCompatibilityEntryResponse> addImageShapeCompatibilityEntry(AddImageShapeCompatibilityEntryRequest request, AsyncHandler<AddImageShapeCompatibilityEntryRequest,AddImageShapeCompatibilityEntryResponse> handler)
ComputeAsync
Adds a shape to the compatible shapes list for the image.
addImageShapeCompatibilityEntry
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<AttachBootVolumeResponse> attachBootVolume(AttachBootVolumeRequest request, AsyncHandler<AttachBootVolumeRequest,AttachBootVolumeResponse> handler)
ComputeAsync
Attaches the specified boot volume to the specified instance.
attachBootVolume
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<AttachVnicResponse> attachVnic(AttachVnicRequest request, AsyncHandler<AttachVnicRequest,AttachVnicResponse> handler)
ComputeAsync
Creates a secondary VNIC and attaches it to the specified instance. For more information about secondary VNICs, see Virtual Network Interface Cards (VNICs).
attachVnic
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<AttachVolumeResponse> attachVolume(AttachVolumeRequest request, AsyncHandler<AttachVolumeRequest,AttachVolumeResponse> handler)
ComputeAsync
Attaches the specified storage volume to the specified instance.
attachVolume
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CaptureConsoleHistoryResponse> captureConsoleHistory(CaptureConsoleHistoryRequest request, AsyncHandler<CaptureConsoleHistoryRequest,CaptureConsoleHistoryResponse> handler)
ComputeAsync
Captures the most recent serial console data (up to a megabyte) for the specified instance.
The `CaptureConsoleHistory` operation works with the other console history operations as described below.
1. Use `CaptureConsoleHistory` to request the capture of up to a megabyte of the most recent console history. This call returns a `ConsoleHistory` object. The object will have a state of REQUESTED. 2. Wait for the capture operation to succeed by polling `GetConsoleHistory` with the identifier of the console history metadata. The state of the `ConsoleHistory` object will go from REQUESTED to GETTING-HISTORY and then SUCCEEDED (or FAILED). 3. Use `GetConsoleHistoryContent` to get the actual console history data (not the metadata). 4. Optionally, use `DeleteConsoleHistory` to delete the console history metadata and the console history data.
captureConsoleHistory
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeComputeCapacityReservationCompartmentResponse> changeComputeCapacityReservationCompartment(ChangeComputeCapacityReservationCompartmentRequest request, AsyncHandler<ChangeComputeCapacityReservationCompartmentRequest,ChangeComputeCapacityReservationCompartmentResponse> handler)
ComputeAsync
Moves a compute capacity reservation into a different compartment. For information about moving resources between compartments, see Moving Resources to a Different Compartment.
changeComputeCapacityReservationCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeComputeCapacityTopologyCompartmentResponse> changeComputeCapacityTopologyCompartment(ChangeComputeCapacityTopologyCompartmentRequest request, AsyncHandler<ChangeComputeCapacityTopologyCompartmentRequest,ChangeComputeCapacityTopologyCompartmentResponse> handler)
ComputeAsync
Moves a compute capacity topology into a different compartment. For information about moving resources between compartments, see Moving Resources to a Different Compartment.
changeComputeCapacityTopologyCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeComputeClusterCompartmentResponse> changeComputeClusterCompartment(ChangeComputeClusterCompartmentRequest request, AsyncHandler<ChangeComputeClusterCompartmentRequest,ChangeComputeClusterCompartmentResponse> handler)
ComputeAsync
Moves a compute cluster into a different compartment within the same tenancy. A compute cluster is a remote direct memory access (RDMA) network group.
For information about moving resources between compartments, see [Moving Resources to a Different Compartment](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).
changeComputeClusterCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeComputeImageCapabilitySchemaCompartmentResponse> changeComputeImageCapabilitySchemaCompartment(ChangeComputeImageCapabilitySchemaCompartmentRequest request, AsyncHandler<ChangeComputeImageCapabilitySchemaCompartmentRequest,ChangeComputeImageCapabilitySchemaCompartmentResponse> handler)
ComputeAsync
Moves a compute image capability schema into a different compartment within the same tenancy. For information about moving resources between compartments, see Moving Resources to a Different Compartment.
changeComputeImageCapabilitySchemaCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeDedicatedVmHostCompartmentResponse> changeDedicatedVmHostCompartment(ChangeDedicatedVmHostCompartmentRequest request, AsyncHandler<ChangeDedicatedVmHostCompartmentRequest,ChangeDedicatedVmHostCompartmentResponse> handler)
ComputeAsync
Moves a dedicated virtual machine host from one compartment to another.
changeDedicatedVmHostCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeImageCompartmentResponse> changeImageCompartment(ChangeImageCompartmentRequest request, AsyncHandler<ChangeImageCompartmentRequest,ChangeImageCompartmentResponse> handler)
ComputeAsync
Moves an image into a different compartment within the same tenancy. For information about moving resources between compartments, see Moving Resources to a Different Compartment.
changeImageCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeInstanceCompartmentResponse> changeInstanceCompartment(ChangeInstanceCompartmentRequest request, AsyncHandler<ChangeInstanceCompartmentRequest,ChangeInstanceCompartmentResponse> handler)
ComputeAsync
Moves an instance into a different compartment within the same tenancy. For information about moving resources between compartments, see Moving Resources to a Different Compartment.
When you move an instance to a different compartment, associated resources such as boot volumes and VNICs are not moved.
changeInstanceCompartment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateAppCatalogSubscriptionResponse> createAppCatalogSubscription(CreateAppCatalogSubscriptionRequest request, AsyncHandler<CreateAppCatalogSubscriptionRequest,CreateAppCatalogSubscriptionResponse> handler)
ComputeAsync
Create a subscription for listing resource version for a compartment. It will take some time to propagate to all regions.
createAppCatalogSubscription
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateComputeCapacityReportResponse> createComputeCapacityReport(CreateComputeCapacityReportRequest request, AsyncHandler<CreateComputeCapacityReportRequest,CreateComputeCapacityReportResponse> handler)
ComputeAsync
Generates a report of the host capacity within an availability domain that is available for you to create compute instances. Host capacity is the physical infrastructure that resources such as compute instances run on.
Use the capacity report to determine whether sufficient capacity is available for a shape before you create an instance or change the shape of an instance.
createComputeCapacityReport
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateComputeCapacityReservationResponse> createComputeCapacityReservation(CreateComputeCapacityReservationRequest request, AsyncHandler<CreateComputeCapacityReservationRequest,CreateComputeCapacityReservationResponse> handler)
ComputeAsync
Creates a new compute capacity reservation in the specified compartment and availability domain. Compute capacity reservations let you reserve instances in a compartment. When you launch an instance using this reservation, you are assured that you have enough space for your instance, and you won’t get out of capacity errors. For more information, see Reserved Capacity.
createComputeCapacityReservation
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateComputeCapacityTopologyResponse> createComputeCapacityTopology(CreateComputeCapacityTopologyRequest request, AsyncHandler<CreateComputeCapacityTopologyRequest,CreateComputeCapacityTopologyResponse> handler)
ComputeAsync
Creates a new compute capacity topology in the specified compartment and availability domain.
Compute capacity topologies provide the RDMA network topology of your bare metal hosts so that you can launch instances on your bare metal hosts with targeted network locations.
Compute capacity topologies report the health status of your bare metal hosts.
createComputeCapacityTopology
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateComputeClusterResponse> createComputeCluster(CreateComputeClusterRequest request, AsyncHandler<CreateComputeClusterRequest,CreateComputeClusterResponse> handler)
ComputeAsync
Creates an empty compute cluster. A compute cluster is a remote direct memory access (RDMA) network group.
After the compute cluster is created, you can use the compute cluster's OCID with the
launchInstance
operation
to create instances in the compute cluster. The instances must be created in the same
compartment and availability domain as the cluster.
Use compute clusters when you want to manage instances in the cluster individually in the RDMA network group.
If you want predictable capacity for a specific number of identical instances that are
managed as a group, create a cluster network that uses instance pools by using the createClusterNetwork
operation.
createComputeCluster
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateComputeImageCapabilitySchemaResponse> createComputeImageCapabilitySchema(CreateComputeImageCapabilitySchemaRequest request, AsyncHandler<CreateComputeImageCapabilitySchemaRequest,CreateComputeImageCapabilitySchemaResponse> handler)
ComputeAsync
Creates compute image capability schema.
createComputeImageCapabilitySchema
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateDedicatedVmHostResponse> createDedicatedVmHost(CreateDedicatedVmHostRequest request, AsyncHandler<CreateDedicatedVmHostRequest,CreateDedicatedVmHostResponse> handler)
ComputeAsync
Creates a new dedicated virtual machine host in the specified compartment and the specified availability domain. Dedicated virtual machine hosts enable you to run your Compute virtual machine (VM) instances on dedicated servers that are a single tenant and not shared with other customers. For more information, see Dedicated Virtual Machine Hosts.
createDedicatedVmHost
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateImageResponse> createImage(CreateImageRequest request, AsyncHandler<CreateImageRequest,CreateImageResponse> handler)
ComputeAsync
Creates a boot disk image for the specified instance or imports an exported image from the Oracle Cloud Infrastructure Object Storage service.
When creating a new image, you must provide the OCID of the instance you want to use as the basis for the image, and the OCID of the compartment containing that instance. For more information about images, see [Managing Custom Images](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/managingcustomimages.htm).
When importing an exported image from Object Storage, you specify the source information
in imageSourceDetails
.
When importing an image based on the namespace, bucket name, and object name, use imageSourceViaObjectStorageTupleDetails
.
When importing an image based on the Object Storage URL, use imageSourceViaObjectStorageUriDetails
. See [Object Storage
URLs](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/imageimportexport.htm#URLs)
and [Using Pre-Authenticated
Requests](https://docs.cloud.oracle.com/iaas/Content/Object/Tasks/usingpreauthenticatedrequests.htm)
for constructing URLs for image import/export.
For more information about importing exported images, see [Image Import/Export](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/imageimportexport.htm).
You may optionally specify a *display name* for the image, which is simply a friendly name
or description. It does not have to be unique, and you can change it. See updateImage
. Avoid entering
confidential information.
createImage
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateInstanceConsoleConnectionResponse> createInstanceConsoleConnection(CreateInstanceConsoleConnectionRequest request, AsyncHandler<CreateInstanceConsoleConnectionRequest,CreateInstanceConsoleConnectionResponse> handler)
ComputeAsync
Creates a new console connection to the specified instance. After the console connection has been created and is available, you connect to the console using SSH.
For more information about instance console connections, see [Troubleshooting Instances Using Instance Console Connections](https://docs.cloud.oracle.com/iaas/Content/Compute/References/serialconsole.htm).
createInstanceConsoleConnection
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteAppCatalogSubscriptionResponse> deleteAppCatalogSubscription(DeleteAppCatalogSubscriptionRequest request, AsyncHandler<DeleteAppCatalogSubscriptionRequest,DeleteAppCatalogSubscriptionResponse> handler)
ComputeAsync
Delete a subscription for a listing resource version for a compartment.
deleteAppCatalogSubscription
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteComputeCapacityReservationResponse> deleteComputeCapacityReservation(DeleteComputeCapacityReservationRequest request, AsyncHandler<DeleteComputeCapacityReservationRequest,DeleteComputeCapacityReservationResponse> handler)
ComputeAsync
Deletes the specified compute capacity reservation.
deleteComputeCapacityReservation
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteComputeCapacityTopologyResponse> deleteComputeCapacityTopology(DeleteComputeCapacityTopologyRequest request, AsyncHandler<DeleteComputeCapacityTopologyRequest,DeleteComputeCapacityTopologyResponse> handler)
ComputeAsync
Deletes the specified compute capacity topology.
deleteComputeCapacityTopology
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteComputeClusterResponse> deleteComputeCluster(DeleteComputeClusterRequest request, AsyncHandler<DeleteComputeClusterRequest,DeleteComputeClusterResponse> handler)
ComputeAsync
Deletes a compute cluster. A compute cluster is a remote direct memory access (RDMA) network group.
Before you delete a compute cluster, first delete all instances in the cluster by using
the terminateInstance
operation.
deleteComputeCluster
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteComputeImageCapabilitySchemaResponse> deleteComputeImageCapabilitySchema(DeleteComputeImageCapabilitySchemaRequest request, AsyncHandler<DeleteComputeImageCapabilitySchemaRequest,DeleteComputeImageCapabilitySchemaResponse> handler)
ComputeAsync
Deletes the specified Compute Image Capability Schema
deleteComputeImageCapabilitySchema
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteConsoleHistoryResponse> deleteConsoleHistory(DeleteConsoleHistoryRequest request, AsyncHandler<DeleteConsoleHistoryRequest,DeleteConsoleHistoryResponse> handler)
ComputeAsync
Deletes the specified console history metadata and the console history data.
deleteConsoleHistory
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteDedicatedVmHostResponse> deleteDedicatedVmHost(DeleteDedicatedVmHostRequest request, AsyncHandler<DeleteDedicatedVmHostRequest,DeleteDedicatedVmHostResponse> handler)
ComputeAsync
Deletes the specified dedicated virtual machine host.
If any VM instances are assigned to the dedicated virtual machine host, the delete operation will fail and the service will return a 409 response code.
deleteDedicatedVmHost
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteImageResponse> deleteImage(DeleteImageRequest request, AsyncHandler<DeleteImageRequest,DeleteImageResponse> handler)
ComputeAsync
Deletes an image.
deleteImage
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteInstanceConsoleConnectionResponse> deleteInstanceConsoleConnection(DeleteInstanceConsoleConnectionRequest request, AsyncHandler<DeleteInstanceConsoleConnectionRequest,DeleteInstanceConsoleConnectionResponse> handler)
ComputeAsync
Deletes the specified instance console connection.
deleteInstanceConsoleConnection
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DetachBootVolumeResponse> detachBootVolume(DetachBootVolumeRequest request, AsyncHandler<DetachBootVolumeRequest,DetachBootVolumeResponse> handler)
ComputeAsync
Detaches a boot volume from an instance. You must specify the OCID of the boot volume attachment.
This is an asynchronous operation. The attachment's `lifecycleState` will change to DETACHING temporarily until the attachment is completely removed.
detachBootVolume
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DetachVnicResponse> detachVnic(DetachVnicRequest request, AsyncHandler<DetachVnicRequest,DetachVnicResponse> handler)
ComputeAsync
Detaches and deletes the specified secondary VNIC. This operation cannot be used on the instance’s primary VNIC. When you terminate an instance, all attached VNICs (primary and secondary) are automatically detached and deleted.
*Important:** If the VNIC has a PrivateIp
that is the [target of a route
rule](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingroutetables.htm#privateip),
deleting the VNIC causes that route rule to blackhole and the traffic will be dropped.
detachVnic
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DetachVolumeResponse> detachVolume(DetachVolumeRequest request, AsyncHandler<DetachVolumeRequest,DetachVolumeResponse> handler)
ComputeAsync
Detaches a storage volume from an instance. You must specify the OCID of the volume attachment.
This is an asynchronous operation. The attachment's `lifecycleState` will change to DETACHING temporarily until the attachment is completely removed.
detachVolume
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ExportImageResponse> exportImage(ExportImageRequest request, AsyncHandler<ExportImageRequest,ExportImageResponse> handler)
ComputeAsync
Exports the specified image to the Oracle Cloud Infrastructure Object Storage service. You can use the Object Storage URL, or the namespace, bucket name, and object name when specifying the location to export to.
For more information about exporting images, see [Image Import/Export](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/imageimportexport.htm).
To perform an image export, you need write access to the Object Storage bucket for the image, see [Let Users Write Objects to Object Storage Buckets](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/commonpolicies.htm#Let4).
See [Object Storage URLs](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/imageimportexport.htm#URLs) and [Using Pre-Authenticated Requests](https://docs.cloud.oracle.com/iaas/Content/Object/Tasks/usingpreauthenticatedrequests.htm) for constructing URLs for image import/export.
exportImage
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAppCatalogListingResponse> getAppCatalogListing(GetAppCatalogListingRequest request, AsyncHandler<GetAppCatalogListingRequest,GetAppCatalogListingResponse> handler)
ComputeAsync
Gets the specified listing.
getAppCatalogListing
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAppCatalogListingAgreementsResponse> getAppCatalogListingAgreements(GetAppCatalogListingAgreementsRequest request, AsyncHandler<GetAppCatalogListingAgreementsRequest,GetAppCatalogListingAgreementsResponse> handler)
ComputeAsync
Retrieves the agreements for a particular resource version of a listing.
getAppCatalogListingAgreements
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAppCatalogListingResourceVersionResponse> getAppCatalogListingResourceVersion(GetAppCatalogListingResourceVersionRequest request, AsyncHandler<GetAppCatalogListingResourceVersionRequest,GetAppCatalogListingResourceVersionResponse> handler)
ComputeAsync
Gets the specified listing resource version.
getAppCatalogListingResourceVersion
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetBootVolumeAttachmentResponse> getBootVolumeAttachment(GetBootVolumeAttachmentRequest request, AsyncHandler<GetBootVolumeAttachmentRequest,GetBootVolumeAttachmentResponse> handler)
ComputeAsync
Gets information about the specified boot volume attachment.
getBootVolumeAttachment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetComputeCapacityReservationResponse> getComputeCapacityReservation(GetComputeCapacityReservationRequest request, AsyncHandler<GetComputeCapacityReservationRequest,GetComputeCapacityReservationResponse> handler)
ComputeAsync
Gets information about the specified compute capacity reservation.
getComputeCapacityReservation
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetComputeCapacityTopologyResponse> getComputeCapacityTopology(GetComputeCapacityTopologyRequest request, AsyncHandler<GetComputeCapacityTopologyRequest,GetComputeCapacityTopologyResponse> handler)
ComputeAsync
Gets information about the specified compute capacity topology.
getComputeCapacityTopology
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetComputeClusterResponse> getComputeCluster(GetComputeClusterRequest request, AsyncHandler<GetComputeClusterRequest,GetComputeClusterResponse> handler)
ComputeAsync
Gets information about a compute cluster. A compute cluster is a remote direct memory access (RDMA) network group.
getComputeCluster
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetComputeGlobalImageCapabilitySchemaResponse> getComputeGlobalImageCapabilitySchema(GetComputeGlobalImageCapabilitySchemaRequest request, AsyncHandler<GetComputeGlobalImageCapabilitySchemaRequest,GetComputeGlobalImageCapabilitySchemaResponse> handler)
ComputeAsync
Gets the specified Compute Global Image Capability Schema
getComputeGlobalImageCapabilitySchema
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetComputeGlobalImageCapabilitySchemaVersionResponse> getComputeGlobalImageCapabilitySchemaVersion(GetComputeGlobalImageCapabilitySchemaVersionRequest request, AsyncHandler<GetComputeGlobalImageCapabilitySchemaVersionRequest,GetComputeGlobalImageCapabilitySchemaVersionResponse> handler)
ComputeAsync
Gets the specified Compute Global Image Capability Schema Version
getComputeGlobalImageCapabilitySchemaVersion
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetComputeImageCapabilitySchemaResponse> getComputeImageCapabilitySchema(GetComputeImageCapabilitySchemaRequest request, AsyncHandler<GetComputeImageCapabilitySchemaRequest,GetComputeImageCapabilitySchemaResponse> handler)
ComputeAsync
Gets the specified Compute Image Capability Schema
getComputeImageCapabilitySchema
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetConsoleHistoryResponse> getConsoleHistory(GetConsoleHistoryRequest request, AsyncHandler<GetConsoleHistoryRequest,GetConsoleHistoryResponse> handler)
ComputeAsync
Shows the metadata for the specified console history. See captureConsoleHistory
for details about using the console history operations.
getConsoleHistory
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetConsoleHistoryContentResponse> getConsoleHistoryContent(GetConsoleHistoryContentRequest request, AsyncHandler<GetConsoleHistoryContentRequest,GetConsoleHistoryContentResponse> handler)
ComputeAsync
Gets the actual console history data (not the metadata). See captureConsoleHistory
for details about using the console history operations.
getConsoleHistoryContent
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDedicatedVmHostResponse> getDedicatedVmHost(GetDedicatedVmHostRequest request, AsyncHandler<GetDedicatedVmHostRequest,GetDedicatedVmHostResponse> handler)
ComputeAsync
Gets information about the specified dedicated virtual machine host.
getDedicatedVmHost
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetImageResponse> getImage(GetImageRequest request, AsyncHandler<GetImageRequest,GetImageResponse> handler)
ComputeAsync
Gets the specified image.
getImage
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetImageShapeCompatibilityEntryResponse> getImageShapeCompatibilityEntry(GetImageShapeCompatibilityEntryRequest request, AsyncHandler<GetImageShapeCompatibilityEntryRequest,GetImageShapeCompatibilityEntryResponse> handler)
ComputeAsync
Retrieves an image shape compatibility entry.
getImageShapeCompatibilityEntry
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetInstanceResponse> getInstance(GetInstanceRequest request, AsyncHandler<GetInstanceRequest,GetInstanceResponse> handler)
ComputeAsync
Gets information about the specified instance.
*Note:** To retrieve public and private IP addresses for an instance, use the listVnicAttachments
operation to get the VNIC ID for the instance, and then call getVnic
with the VNIC ID.
getInstance
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetInstanceConsoleConnectionResponse> getInstanceConsoleConnection(GetInstanceConsoleConnectionRequest request, AsyncHandler<GetInstanceConsoleConnectionRequest,GetInstanceConsoleConnectionResponse> handler)
ComputeAsync
Gets the specified instance console connection’s information.
getInstanceConsoleConnection
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetInstanceMaintenanceEventResponse> getInstanceMaintenanceEvent(GetInstanceMaintenanceEventRequest request, AsyncHandler<GetInstanceMaintenanceEventRequest,GetInstanceMaintenanceEventResponse> handler)
ComputeAsync
Gets the maintenance event for the given instance.
getInstanceMaintenanceEvent
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetInstanceMaintenanceRebootResponse> getInstanceMaintenanceReboot(GetInstanceMaintenanceRebootRequest request, AsyncHandler<GetInstanceMaintenanceRebootRequest,GetInstanceMaintenanceRebootResponse> handler)
ComputeAsync
Gets the maximum possible date that a maintenance reboot can be extended. For more information, see Infrastructure Maintenance.
getInstanceMaintenanceReboot
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetMeasuredBootReportResponse> getMeasuredBootReport(GetMeasuredBootReportRequest request, AsyncHandler<GetMeasuredBootReportRequest,GetMeasuredBootReportResponse> handler)
ComputeAsync
Gets the measured boot report for this shielded instance.
getMeasuredBootReport
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetVnicAttachmentResponse> getVnicAttachment(GetVnicAttachmentRequest request, AsyncHandler<GetVnicAttachmentRequest,GetVnicAttachmentResponse> handler)
ComputeAsync
Gets the information for the specified VNIC attachment.
getVnicAttachment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetVolumeAttachmentResponse> getVolumeAttachment(GetVolumeAttachmentRequest request, AsyncHandler<GetVolumeAttachmentRequest,GetVolumeAttachmentResponse> handler)
ComputeAsync
Gets information about the specified volume attachment.
getVolumeAttachment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetWindowsInstanceInitialCredentialsResponse> getWindowsInstanceInitialCredentials(GetWindowsInstanceInitialCredentialsRequest request, AsyncHandler<GetWindowsInstanceInitialCredentialsRequest,GetWindowsInstanceInitialCredentialsResponse> handler)
ComputeAsync
Gets the generated credentials for the instance. Only works for instances that require a password to log in, such as Windows. For certain operating systems, users will be forced to change the initial credentials.
getWindowsInstanceInitialCredentials
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<InstanceActionResponse> instanceAction(InstanceActionRequest request, AsyncHandler<InstanceActionRequest,InstanceActionResponse> handler)
ComputeAsync
Performs one of the following power actions on the specified instance:
- **START** - Powers on the instance.
- **STOP** - Powers off the instance.
- **RESET** - Powers off the instance and then powers it back on.
- **SOFTSTOP** - Gracefully shuts down the instance by sending a shutdown command to the operating system. After waiting 15 minutes for the OS to shut down, the instance is powered off. If the applications that run on the instance take more than 15 minutes to shut down, they could be improperly stopped, resulting in data corruption. To avoid this, manually shut down the instance using the commands available in the OS before you softstop the instance.
- **SOFTRESET** - Gracefully reboots the instance by sending a shutdown command to the operating system. After waiting 15 minutes for the OS to shut down, the instance is powered off and then powered back on.
- **SENDDIAGNOSTICINTERRUPT** - For advanced users. **Caution: Sending a diagnostic interrupt to a live system can cause data corruption or system failure.** Sends a diagnostic interrupt that causes the instance's OS to crash and then reboot. Before you send a diagnostic interrupt, you must configure the instance to generate a crash dump file when it crashes. The crash dump captures information about the state of the OS at the time of the crash. After the OS restarts, you can analyze the crash dump to diagnose the issue. For more information, see [Sending a Diagnostic Interrupt](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/sendingdiagnosticinterrupt.htm).
- **DIAGNOSTICREBOOT** - Powers off the instance, rebuilds it, and then powers it back on. Before you send a diagnostic reboot, restart the instance's OS, confirm that the instance and networking settings are configured correctly, and try other [troubleshooting steps](https://docs.cloud.oracle.com/iaas/Content/Compute/References/troubleshooting-compute-instances.htm). Use diagnostic reboot as a final attempt to troubleshoot an unreachable instance. For virtual machine (VM) instances only. For more information, see [Performing a Diagnostic Reboot](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/diagnostic-reboot.htm).
- **REBOOTMIGRATE** - Powers off the instance, moves it to new hardware, and then powers it back on. For more information, see [Infrastructure Maintenance](https://docs.cloud.oracle.com/iaas/Content/Compute/References/infrastructure-maintenance.htm).
For more information about managing instance lifecycle states, see [Stopping and Starting an Instance](https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/restartinginstance.htm).
instanceAction
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<LaunchInstanceResponse> launchInstance(LaunchInstanceRequest request, AsyncHandler<LaunchInstanceRequest,LaunchInstanceResponse> handler)
ComputeAsync
Creates a new instance in the specified compartment and the specified availability domain. For general information about instances, see Overview of the Compute Service.
For information about access control and compartments, see [Overview of the IAM Service](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/overview.htm).
For information about availability domains, see [Regions and Availability Domains](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/regions.htm). To get a list of availability domains, use the `ListAvailabilityDomains` operation in the Identity and Access Management Service API.
All Oracle Cloud Infrastructure resources, including instances, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the resource in the Console.
To launch an instance using an image or a boot volume use the `sourceDetails` parameter in
LaunchInstanceDetails
.
When you launch an instance, it is automatically attached to a virtual network interface
card (VNIC), called the *primary VNIC*. The VNIC has a private IP address from the subnet's
CIDR. You can either assign a private IP address of your choice or let Oracle automatically
assign one. You can choose whether the instance has a public IP address. To retrieve the
addresses, use the listVnicAttachments
operation to get the VNIC ID for the instance, and then call
getVnic
with the VNIC ID.
You can later add secondary VNICs to an instance. For more information, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm).
To launch an instance from a Marketplace image listing, you must provide the image ID of
the listing resource version that you want, but you also must subscribe to the listing before
you try to launch the instance. To subscribe to the listing, use the getAppCatalogListingAgreements
operation to get the signature for the terms of use agreement
for the desired listing resource version. Then, call createAppCatalogSubscription
with the signature. To get the image ID for the LaunchInstance
operation, call getAppCatalogListingResourceVersion
.
When launching an instance, you may provide the `securityAttributes` parameter in LaunchInstanceDetails
to manage security attributes via the instance, or in the embedded
CreateVnicDetails
to manage security attributes via the VNIC directly, but not both.
Providing `securityAttributes` in both locations will return a 400 Bad Request response.
To determine whether capacity is available for a specific shape before you create an
instance, use the createComputeCapacityReport
operation.
launchInstance
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAppCatalogListingResourceVersionsResponse> listAppCatalogListingResourceVersions(ListAppCatalogListingResourceVersionsRequest request, AsyncHandler<ListAppCatalogListingResourceVersionsRequest,ListAppCatalogListingResourceVersionsResponse> handler)
ComputeAsync
Gets all resource versions for a particular listing.
listAppCatalogListingResourceVersions
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAppCatalogListingsResponse> listAppCatalogListings(ListAppCatalogListingsRequest request, AsyncHandler<ListAppCatalogListingsRequest,ListAppCatalogListingsResponse> handler)
ComputeAsync
Lists the published listings.
listAppCatalogListings
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAppCatalogSubscriptionsResponse> listAppCatalogSubscriptions(ListAppCatalogSubscriptionsRequest request, AsyncHandler<ListAppCatalogSubscriptionsRequest,ListAppCatalogSubscriptionsResponse> handler)
ComputeAsync
Lists subscriptions for a compartment.
listAppCatalogSubscriptions
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListBootVolumeAttachmentsResponse> listBootVolumeAttachments(ListBootVolumeAttachmentsRequest request, AsyncHandler<ListBootVolumeAttachmentsRequest,ListBootVolumeAttachmentsResponse> handler)
ComputeAsync
Lists the boot volume attachments in the specified compartment. You can filter the list by specifying an instance OCID, boot volume OCID, or both.
listBootVolumeAttachments
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityReservationInstanceShapesResponse> listComputeCapacityReservationInstanceShapes(ListComputeCapacityReservationInstanceShapesRequest request, AsyncHandler<ListComputeCapacityReservationInstanceShapesRequest,ListComputeCapacityReservationInstanceShapesResponse> handler)
ComputeAsync
Lists the shapes that can be reserved within the specified compartment.
listComputeCapacityReservationInstanceShapes
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityReservationInstancesResponse> listComputeCapacityReservationInstances(ListComputeCapacityReservationInstancesRequest request, AsyncHandler<ListComputeCapacityReservationInstancesRequest,ListComputeCapacityReservationInstancesResponse> handler)
ComputeAsync
Lists the instances launched under a capacity reservation. You can filter results by specifying criteria.
listComputeCapacityReservationInstances
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityReservationsResponse> listComputeCapacityReservations(ListComputeCapacityReservationsRequest request, AsyncHandler<ListComputeCapacityReservationsRequest,ListComputeCapacityReservationsResponse> handler)
ComputeAsync
Lists the compute capacity reservations that match the specified criteria and compartment.
You can limit the list by specifying a compute capacity reservation display name (the list will include all the identically-named compute capacity reservations in the compartment).
listComputeCapacityReservations
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityTopologiesResponse> listComputeCapacityTopologies(ListComputeCapacityTopologiesRequest request, AsyncHandler<ListComputeCapacityTopologiesRequest,ListComputeCapacityTopologiesResponse> handler)
ComputeAsync
Lists the compute capacity topologies in the specified compartment. You can filter the list by a compute capacity topology display name.
listComputeCapacityTopologies
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityTopologyComputeBareMetalHostsResponse> listComputeCapacityTopologyComputeBareMetalHosts(ListComputeCapacityTopologyComputeBareMetalHostsRequest request, AsyncHandler<ListComputeCapacityTopologyComputeBareMetalHostsRequest,ListComputeCapacityTopologyComputeBareMetalHostsResponse> handler)
ComputeAsync
Lists compute bare metal hosts in the specified compute capacity topology.
listComputeCapacityTopologyComputeBareMetalHosts
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityTopologyComputeHpcIslandsResponse> listComputeCapacityTopologyComputeHpcIslands(ListComputeCapacityTopologyComputeHpcIslandsRequest request, AsyncHandler<ListComputeCapacityTopologyComputeHpcIslandsRequest,ListComputeCapacityTopologyComputeHpcIslandsResponse> handler)
ComputeAsync
Lists compute HPC islands in the specified compute capacity topology.
listComputeCapacityTopologyComputeHpcIslands
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeCapacityTopologyComputeNetworkBlocksResponse> listComputeCapacityTopologyComputeNetworkBlocks(ListComputeCapacityTopologyComputeNetworkBlocksRequest request, AsyncHandler<ListComputeCapacityTopologyComputeNetworkBlocksRequest,ListComputeCapacityTopologyComputeNetworkBlocksResponse> handler)
ComputeAsync
Lists compute network blocks in the specified compute capacity topology.
listComputeCapacityTopologyComputeNetworkBlocks
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeClustersResponse> listComputeClusters(ListComputeClustersRequest request, AsyncHandler<ListComputeClustersRequest,ListComputeClustersResponse> handler)
ComputeAsync
Lists the compute clusters in the specified compartment. A compute cluster is a remote direct memory access (RDMA) network group.
listComputeClusters
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeGlobalImageCapabilitySchemaVersionsResponse> listComputeGlobalImageCapabilitySchemaVersions(ListComputeGlobalImageCapabilitySchemaVersionsRequest request, AsyncHandler<ListComputeGlobalImageCapabilitySchemaVersionsRequest,ListComputeGlobalImageCapabilitySchemaVersionsResponse> handler)
ComputeAsync
Lists Compute Global Image Capability Schema versions in the specified compartment.
listComputeGlobalImageCapabilitySchemaVersions
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeGlobalImageCapabilitySchemasResponse> listComputeGlobalImageCapabilitySchemas(ListComputeGlobalImageCapabilitySchemasRequest request, AsyncHandler<ListComputeGlobalImageCapabilitySchemasRequest,ListComputeGlobalImageCapabilitySchemasResponse> handler)
ComputeAsync
Lists Compute Global Image Capability Schema in the specified compartment.
listComputeGlobalImageCapabilitySchemas
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListComputeImageCapabilitySchemasResponse> listComputeImageCapabilitySchemas(ListComputeImageCapabilitySchemasRequest request, AsyncHandler<ListComputeImageCapabilitySchemasRequest,ListComputeImageCapabilitySchemasResponse> handler)
ComputeAsync
Lists Compute Image Capability Schema in the specified compartment. You can also query by a specific imageId.
listComputeImageCapabilitySchemas
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListConsoleHistoriesResponse> listConsoleHistories(ListConsoleHistoriesRequest request, AsyncHandler<ListConsoleHistoriesRequest,ListConsoleHistoriesResponse> handler)
ComputeAsync
Lists the console history metadata for the specified compartment or instance.
listConsoleHistories
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDedicatedVmHostInstanceShapesResponse> listDedicatedVmHostInstanceShapes(ListDedicatedVmHostInstanceShapesRequest request, AsyncHandler<ListDedicatedVmHostInstanceShapesRequest,ListDedicatedVmHostInstanceShapesResponse> handler)
ComputeAsync
Lists the shapes that can be used to launch a virtual machine instance on a dedicated virtual machine host within the specified compartment. You can filter the list by compatibility with a specific dedicated virtual machine host shape.
listDedicatedVmHostInstanceShapes
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDedicatedVmHostInstancesResponse> listDedicatedVmHostInstances(ListDedicatedVmHostInstancesRequest request, AsyncHandler<ListDedicatedVmHostInstancesRequest,ListDedicatedVmHostInstancesResponse> handler)
ComputeAsync
Returns the list of instances on the dedicated virtual machine hosts that match the specified criteria.
listDedicatedVmHostInstances
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDedicatedVmHostShapesResponse> listDedicatedVmHostShapes(ListDedicatedVmHostShapesRequest request, AsyncHandler<ListDedicatedVmHostShapesRequest,ListDedicatedVmHostShapesResponse> handler)
ComputeAsync
Lists the shapes that can be used to launch a dedicated virtual machine host within the specified compartment.
listDedicatedVmHostShapes
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDedicatedVmHostsResponse> listDedicatedVmHosts(ListDedicatedVmHostsRequest request, AsyncHandler<ListDedicatedVmHostsRequest,ListDedicatedVmHostsResponse> handler)
ComputeAsync
Returns the list of dedicated virtual machine hosts that match the specified criteria in the specified compartment.
You can limit the list by specifying a dedicated virtual machine host display name. The list will include all the identically-named dedicated virtual machine hosts in the compartment.
listDedicatedVmHosts
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListImageShapeCompatibilityEntriesResponse> listImageShapeCompatibilityEntries(ListImageShapeCompatibilityEntriesRequest request, AsyncHandler<ListImageShapeCompatibilityEntriesRequest,ListImageShapeCompatibilityEntriesResponse> handler)
ComputeAsync
Lists the compatible shapes for the specified image.
listImageShapeCompatibilityEntries
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListImagesResponse> listImages(ListImagesRequest request, AsyncHandler<ListImagesRequest,ListImagesResponse> handler)
ComputeAsync
Lists a subset of images available in the specified compartment, including platform images and custom images. The list of platform images includes the three most recently published versions of each major distribution. The list does not support filtering based on image tags.
The list of images returned is ordered to first show the recent platform images, then all of the custom images.
*Caution:** Platform images are refreshed regularly. When new images are released, older versions are replaced. The image OCIDs remain available, but when the platform image is replaced, the image OCIDs are no longer returned as part of the platform image list.
listImages
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListInstanceConsoleConnectionsResponse> listInstanceConsoleConnections(ListInstanceConsoleConnectionsRequest request, AsyncHandler<ListInstanceConsoleConnectionsRequest,ListInstanceConsoleConnectionsResponse> handler)
ComputeAsync
Lists the console connections for the specified compartment or instance.
For more information about instance console connections, see [Troubleshooting Instances Using Instance Console Connections](https://docs.cloud.oracle.com/iaas/Content/Compute/References/serialconsole.htm).
listInstanceConsoleConnections
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListInstanceDevicesResponse> listInstanceDevices(ListInstanceDevicesRequest request, AsyncHandler<ListInstanceDevicesRequest,ListInstanceDevicesResponse> handler)
ComputeAsync
Gets a list of all the devices for given instance. You can optionally filter results by device availability.
listInstanceDevices
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListInstanceMaintenanceEventsResponse> listInstanceMaintenanceEvents(ListInstanceMaintenanceEventsRequest request, AsyncHandler<ListInstanceMaintenanceEventsRequest,ListInstanceMaintenanceEventsResponse> handler)
ComputeAsync
Gets a list of all the maintenance events for the given instance.
listInstanceMaintenanceEvents
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListInstancesResponse> listInstances(ListInstancesRequest request, AsyncHandler<ListInstancesRequest,ListInstancesResponse> handler)
ComputeAsync
Lists the instances in the specified compartment and the specified availability domain. You can filter the results by specifying an instance name (the list will include all the identically-named instances in the compartment).
*Note:** To retrieve public and private IP addresses for an instance, use the listVnicAttachments
operation to get the VNIC ID for the instance, and then call getVnic
with the VNIC ID.
listInstances
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListShapesResponse> listShapes(ListShapesRequest request, AsyncHandler<ListShapesRequest,ListShapesResponse> handler)
ComputeAsync
Lists the shapes that can be used to launch an instance within the specified compartment. You can filter the list by compatibility with a specific image.
listShapes
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListVnicAttachmentsResponse> listVnicAttachments(ListVnicAttachmentsRequest request, AsyncHandler<ListVnicAttachmentsRequest,ListVnicAttachmentsResponse> handler)
ComputeAsync
Lists the VNIC attachments in the specified compartment. A VNIC attachment resides in the same compartment as the attached instance. The list can be filtered by instance, VNIC, or availability domain.
listVnicAttachments
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListVolumeAttachmentsResponse> listVolumeAttachments(ListVolumeAttachmentsRequest request, AsyncHandler<ListVolumeAttachmentsRequest,ListVolumeAttachmentsResponse> handler)
ComputeAsync
Lists the volume attachments in the specified compartment. You can filter the list by specifying an instance OCID, volume OCID, or both.
Currently, the only supported volume attachment type are IScsiVolumeAttachment
and
ParavirtualizedVolumeAttachment
.
listVolumeAttachments
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<RemoveImageShapeCompatibilityEntryResponse> removeImageShapeCompatibilityEntry(RemoveImageShapeCompatibilityEntryRequest request, AsyncHandler<RemoveImageShapeCompatibilityEntryRequest,RemoveImageShapeCompatibilityEntryResponse> handler)
ComputeAsync
Removes a shape from the compatible shapes list for the image.
removeImageShapeCompatibilityEntry
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<TerminateInstanceResponse> terminateInstance(TerminateInstanceRequest request, AsyncHandler<TerminateInstanceRequest,TerminateInstanceResponse> handler)
ComputeAsync
Permanently terminates (deletes) the specified instance. Any attached VNICs and volumes are automatically detached when the instance terminates.
To preserve the boot volume associated with the instance, specify `true` for `PreserveBootVolumeQueryParam`. To delete the boot volume when the instance is deleted, specify `false` or do not specify a value for `PreserveBootVolumeQueryParam`.
To preserve data volumes created with the instance, specify `true` or do not specify a value for `PreserveDataVolumesQueryParam`. To delete the data volumes when the instance itself is deleted, specify `false` for `PreserveDataVolumesQueryParam`.
This is an asynchronous operation. The instance's `lifecycleState` changes to TERMINATING temporarily until the instance is completely deleted. After the instance is deleted, the record remains visible in the list of instances with the state TERMINATED for at least 12 hours, but no further action is needed.
terminateInstance
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateComputeCapacityReservationResponse> updateComputeCapacityReservation(UpdateComputeCapacityReservationRequest request, AsyncHandler<UpdateComputeCapacityReservationRequest,UpdateComputeCapacityReservationResponse> handler)
ComputeAsync
Updates the specified capacity reservation and its associated capacity configurations. Fields that are not provided in the request will not be updated. Capacity configurations that are not included will be deleted. Avoid entering confidential information.
updateComputeCapacityReservation
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateComputeCapacityTopologyResponse> updateComputeCapacityTopology(UpdateComputeCapacityTopologyRequest request, AsyncHandler<UpdateComputeCapacityTopologyRequest,UpdateComputeCapacityTopologyResponse> handler)
ComputeAsync
Updates the specified compute capacity topology. Fields that are not provided in the request will not be updated.
updateComputeCapacityTopology
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateComputeClusterResponse> updateComputeCluster(UpdateComputeClusterRequest request, AsyncHandler<UpdateComputeClusterRequest,UpdateComputeClusterResponse> handler)
ComputeAsync
Updates a compute cluster. A compute cluster is a remote direct memory access (RDMA) network group.
To create instances within a compute cluster, use the launchInstance
operation.
To delete instances from a compute cluster, use the terminateInstance
operation.
updateComputeCluster
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateComputeImageCapabilitySchemaResponse> updateComputeImageCapabilitySchema(UpdateComputeImageCapabilitySchemaRequest request, AsyncHandler<UpdateComputeImageCapabilitySchemaRequest,UpdateComputeImageCapabilitySchemaResponse> handler)
ComputeAsync
Updates the specified Compute Image Capability Schema
updateComputeImageCapabilitySchema
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateConsoleHistoryResponse> updateConsoleHistory(UpdateConsoleHistoryRequest request, AsyncHandler<UpdateConsoleHistoryRequest,UpdateConsoleHistoryResponse> handler)
ComputeAsync
Updates the specified console history metadata.
updateConsoleHistory
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateDedicatedVmHostResponse> updateDedicatedVmHost(UpdateDedicatedVmHostRequest request, AsyncHandler<UpdateDedicatedVmHostRequest,UpdateDedicatedVmHostResponse> handler)
ComputeAsync
Updates the displayName, freeformTags, and definedTags attributes for the specified dedicated virtual machine host. If an attribute value is not included, it will not be updated.
updateDedicatedVmHost
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateImageResponse> updateImage(UpdateImageRequest request, AsyncHandler<UpdateImageRequest,UpdateImageResponse> handler)
ComputeAsync
Updates the display name of the image. Avoid entering confidential information.
updateImage
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateInstanceResponse> updateInstance(UpdateInstanceRequest request, AsyncHandler<UpdateInstanceRequest,UpdateInstanceResponse> handler)
ComputeAsync
Updates certain fields on the specified instance. Fields that are not provided in the request will not be updated. Avoid entering confidential information.
Changes to metadata fields will be reflected in the instance metadata service (this may take up to a minute).
The OCID of the instance remains the same.
updateInstance
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateInstanceConsoleConnectionResponse> updateInstanceConsoleConnection(UpdateInstanceConsoleConnectionRequest request, AsyncHandler<UpdateInstanceConsoleConnectionRequest,UpdateInstanceConsoleConnectionResponse> handler)
ComputeAsync
Updates the defined tags and free-form tags for the specified instance console connection.
updateInstanceConsoleConnection
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateInstanceMaintenanceEventResponse> updateInstanceMaintenanceEvent(UpdateInstanceMaintenanceEventRequest request, AsyncHandler<UpdateInstanceMaintenanceEventRequest,UpdateInstanceMaintenanceEventResponse> handler)
ComputeAsync
Updates the maintenance event for the given instance.
updateInstanceMaintenanceEvent
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateVolumeAttachmentResponse> updateVolumeAttachment(UpdateVolumeAttachmentRequest request, AsyncHandler<UpdateVolumeAttachmentRequest,UpdateVolumeAttachmentResponse> handler)
ComputeAsync
Updates information about the specified volume attachment.
updateVolumeAttachment
in interface ComputeAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.protected ClientConfigurator getDefaultConfigurator()
public void useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
useOfRealmSpecificEndpointTemplateEnabled
- This flag can be set to true or false to
enable or disable the use of realm-specific endpoint template respectivelypublic final void populateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap)
endpoint
- The endpoint template in userequiredParametersMap
- Map of parameter name as key and value set in request path or
query parameter as valuepublic final void updateBaseEndpoint(String endpoint)
endpoint
- The updated endpoint to usepublic final void setEndpoint(String endpoint)
public final String getEndpoint()
public final void refreshClient()
HttpClient
. This will call ClientConfigurator
s again, and
can be used to e.g. refresh the SSL certificate.public final void close()
close
in interface AutoCloseable
public String getClientCommonLibraryVersion()
public Optional<String> getMinimumClientCommonLibraryVersionFromClient()
protected <REQ extends BmcRequest<?>,RESP extends BmcResponse,RESP_BUILDER extends BmcResponse.Builder<RESP>> ClientCall<REQ,RESP,RESP_BUILDER> clientCall(REQ request, Supplier<RESP_BUILDER> responseBuilder)
Copyright © 2016–2024. All rights reserved.