@Generated(value="OracleSDKGenerator", comments="API Version: 20220618") public class DesktopServiceClient extends BaseSyncClient implements DesktopService
Modifier and Type | Class and Description |
---|---|
static class |
DesktopServiceClient.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 DesktopService.
|
Constructor and Description |
---|
DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint,
ExecutorService executorService)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Deprecated.
Use the
builder instead. |
DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Deprecated.
Use the
builder instead. |
Modifier and Type | Method and Description |
---|---|
static DesktopServiceClient.Builder |
builder()
Create a builder for this client.
|
CancelWorkRequestResponse |
cancelWorkRequest(CancelWorkRequestRequest request)
Cancel work request with the given ID.
|
ChangeDesktopPoolCompartmentResponse |
changeDesktopPoolCompartment(ChangeDesktopPoolCompartmentRequest request)
Moves a desktop pool into a different compartment within the same tenancy.
|
void |
close() |
CreateDesktopPoolResponse |
createDesktopPool(CreateDesktopPoolRequest request)
Creates a desktop pool with the given configuration parameters.
|
DeleteDesktopResponse |
deleteDesktop(DeleteDesktopRequest request)
Deletes the desktop with the specified OCID.
|
DeleteDesktopPoolResponse |
deleteDesktopPool(DeleteDesktopPoolRequest request)
Deletes a desktop pool with the specified OCID.
|
String |
getClientCommonLibraryVersion() |
protected ClientConfigurator |
getDefaultConfigurator() |
GetDesktopResponse |
getDesktop(GetDesktopRequest request)
Provides information about the desktop with the specified OCID.
|
GetDesktopPoolResponse |
getDesktopPool(GetDesktopPoolRequest request)
Returns information about the desktop pool including all configuration parameters and the
current state.
|
String |
getEndpoint() |
Optional<String> |
getMinimumClientCommonLibraryVersionFromClient() |
DesktopServicePaginators |
getPaginators()
Gets the pre-configured paginators available for list operations in this service which may
return multiple pages of data.
|
DesktopServiceWaiters |
getWaiters()
Gets the pre-configured waiters available for resources for this service.
|
GetWorkRequestResponse |
getWorkRequest(GetWorkRequestRequest request)
Gets the status of the work request with the given ID.
|
ListDesktopPoolDesktopsResponse |
listDesktopPoolDesktops(ListDesktopPoolDesktopsRequest request)
Returns a list of desktops within a given desktop pool.
|
ListDesktopPoolsResponse |
listDesktopPools(ListDesktopPoolsRequest request)
Returns a list of desktop pools within the given compartment.
|
ListDesktopPoolVolumesResponse |
listDesktopPoolVolumes(ListDesktopPoolVolumesRequest request)
Returns a list of volumes within the given desktop pool.
|
ListDesktopsResponse |
listDesktops(ListDesktopsRequest request)
Returns a list of desktops filtered by the specified parameters.
|
ListWorkRequestErrorsResponse |
listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Return a (paginated) list of errors for a given work request.
|
ListWorkRequestLogsResponse |
listWorkRequestLogs(ListWorkRequestLogsRequest request)
Return a (paginated) list of logs for a given work request.
|
ListWorkRequestsResponse |
listWorkRequests(ListWorkRequestsRequest request)
Lists the work requests in a compartment.
|
void |
populateServiceParametersInEndpoint(String endpoint,
Map<String,Object> requiredParametersMap)
Populate the parameters in the endpoint with its corresponding value and update the base
endpoint.
|
void |
refreshClient()
Rebuild the backing
HttpClient . |
void |
setEndpoint(String endpoint) |
void |
setRegion(Region region)
Sets the region to call (ex, Region.US_PHOENIX_1).
|
void |
setRegion(String regionId)
Sets the region to call (ex, ‘us-phoenix-1’).
|
StartDesktopResponse |
startDesktop(StartDesktopRequest request)
Starts the desktop with the specified OCID.
|
StartDesktopPoolResponse |
startDesktopPool(StartDesktopPoolRequest request)
Starts the desktop pool with the specified OCID.
|
StopDesktopResponse |
stopDesktop(StopDesktopRequest request)
Stops the desktop with the specified OCID.
|
StopDesktopPoolResponse |
stopDesktopPool(StopDesktopPoolRequest request)
Stops the desktop pool with the specified OCID.
|
void |
updateBaseEndpoint(String endpoint)
This method should be used for parameterized endpoint templates only.
|
UpdateDesktopResponse |
updateDesktop(UpdateDesktopRequest request)
Modifies information about the desktop such as the name.
|
UpdateDesktopPoolResponse |
updateDesktopPool(UpdateDesktopPoolRequest request)
Modifies the configuration of the desktop pool such as the availability, contact information,
description, name, device policy, pool size, standby size, and start or stop time.
|
void |
useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
This method should be used to enable or disable the use of realm-specific endpoint template.
|
clientCall
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
close
public static final Service SERVICE
Service instance for DesktopService.
public final String clientCommonLibraryVersion
@Deprecated public DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)@Deprecated public DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
@Deprecated public DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DesktopServiceClient.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 DesktopServiceClient(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 DesktopServiceClient.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 DesktopServiceClient(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 DesktopServiceClient.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
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DesktopServiceClient.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
executorService
- DesktopServiceClient.Builder.executorService
public static DesktopServiceClient.Builder builder()
Create a builder for this client.
public void setRegion(Region region)
DesktopService
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 DesktopService
region
- The region of the service.public void setRegion(String regionId)
DesktopService
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 DesktopService
regionId
- The public region ID.public CancelWorkRequestResponse cancelWorkRequest(CancelWorkRequestRequest request)
DesktopService
Cancel work request with the given ID.
cancelWorkRequest
in interface DesktopService
request
- The request object containing the details to sendpublic ChangeDesktopPoolCompartmentResponse changeDesktopPoolCompartment(ChangeDesktopPoolCompartmentRequest request)
DesktopService
Moves a desktop pool into a different compartment within the same tenancy. You must provide the OCID of the desktop pool and the OCID of the compartment that you are moving the pool to.
changeDesktopPoolCompartment
in interface DesktopService
request
- The request object containing the details to sendpublic CreateDesktopPoolResponse createDesktopPool(CreateDesktopPoolRequest request)
DesktopService
Creates a desktop pool with the given configuration parameters.
createDesktopPool
in interface DesktopService
request
- The request object containing the details to sendpublic DeleteDesktopResponse deleteDesktop(DeleteDesktopRequest request)
DesktopService
Deletes the desktop with the specified OCID. The service terminates the associated compute instance. The end-user loses access to the desktop instance permanently. Any associated block volume becomes inactive but is not deleted.
deleteDesktop
in interface DesktopService
request
- The request object containing the details to sendpublic DeleteDesktopPoolResponse deleteDesktopPool(DeleteDesktopPoolRequest request)
DesktopService
Deletes a desktop pool with the specified OCID. The service terminates all compute instances and users immediately lose access to their desktops. You can choose to preserve the block volumes associated with the pool.
deleteDesktopPool
in interface DesktopService
request
- The request object containing the details to sendpublic GetDesktopResponse getDesktop(GetDesktopRequest request)
DesktopService
Provides information about the desktop with the specified OCID.
getDesktop
in interface DesktopService
request
- The request object containing the details to sendpublic GetDesktopPoolResponse getDesktopPool(GetDesktopPoolRequest request)
DesktopService
Returns information about the desktop pool including all configuration parameters and the current state.
getDesktopPool
in interface DesktopService
request
- The request object containing the details to sendpublic GetWorkRequestResponse getWorkRequest(GetWorkRequestRequest request)
DesktopService
Gets the status of the work request with the given ID.
getWorkRequest
in interface DesktopService
request
- The request object containing the details to sendpublic ListDesktopPoolDesktopsResponse listDesktopPoolDesktops(ListDesktopPoolDesktopsRequest request)
DesktopService
Returns a list of desktops within a given desktop pool. You can limit the results to an availability domain, desktop name, or desktop state. You can limit the number of results returned, sort the results by time or name, and sort in ascending or descending order.
listDesktopPoolDesktops
in interface DesktopService
request
- The request object containing the details to sendpublic ListDesktopPoolVolumesResponse listDesktopPoolVolumes(ListDesktopPoolVolumesRequest request)
DesktopService
Returns a list of volumes within the given desktop pool. You can limit the results to an availability domain, volume name, or volume state. You can limit the number of results returned, sort the results by time or name, and sort in ascending or descending order.
listDesktopPoolVolumes
in interface DesktopService
request
- The request object containing the details to sendpublic ListDesktopPoolsResponse listDesktopPools(ListDesktopPoolsRequest request)
DesktopService
Returns a list of desktop pools within the given compartment. You can limit the results to an availability domain, pool name, or pool state. You can limit the number of results returned, sort the results by time or name, and sort in ascending or descending order.
listDesktopPools
in interface DesktopService
request
- The request object containing the details to sendpublic ListDesktopsResponse listDesktops(ListDesktopsRequest request)
DesktopService
Returns a list of desktops filtered by the specified parameters. You can limit the results to an availability domain, desktop name, desktop OCID, desktop state, pool OCID, or compartment OCID. You can limit the number of results returned, sort the results by time or name, and sort in ascending or descending order.
listDesktops
in interface DesktopService
request
- The request object containing the details to sendpublic ListWorkRequestErrorsResponse listWorkRequestErrors(ListWorkRequestErrorsRequest request)
DesktopService
Return a (paginated) list of errors for a given work request.
listWorkRequestErrors
in interface DesktopService
request
- The request object containing the details to sendpublic ListWorkRequestLogsResponse listWorkRequestLogs(ListWorkRequestLogsRequest request)
DesktopService
Return a (paginated) list of logs for a given work request.
listWorkRequestLogs
in interface DesktopService
request
- The request object containing the details to sendpublic ListWorkRequestsResponse listWorkRequests(ListWorkRequestsRequest request)
DesktopService
Lists the work requests in a compartment.
listWorkRequests
in interface DesktopService
request
- The request object containing the details to sendpublic StartDesktopResponse startDesktop(StartDesktopRequest request)
DesktopService
Starts the desktop with the specified OCID.
startDesktop
in interface DesktopService
request
- The request object containing the details to sendpublic StartDesktopPoolResponse startDesktopPool(StartDesktopPoolRequest request)
DesktopService
Starts the desktop pool with the specified OCID. Once the pool is ACTIVE, users will have access to their desktops within the pool.
startDesktopPool
in interface DesktopService
request
- The request object containing the details to sendpublic StopDesktopResponse stopDesktop(StopDesktopRequest request)
DesktopService
Stops the desktop with the specified OCID. Stopping a desktop causes the end-user to lose access to their desktop instance until the desktop is restarted.
stopDesktop
in interface DesktopService
request
- The request object containing the details to sendpublic StopDesktopPoolResponse stopDesktopPool(StopDesktopPoolRequest request)
DesktopService
Stops the desktop pool with the specified OCID. Users will lose access to their desktops until you explicitly start the pool again.
stopDesktopPool
in interface DesktopService
request
- The request object containing the details to sendpublic UpdateDesktopResponse updateDesktop(UpdateDesktopRequest request)
DesktopService
Modifies information about the desktop such as the name.
updateDesktop
in interface DesktopService
request
- The request object containing the details to sendpublic UpdateDesktopPoolResponse updateDesktopPool(UpdateDesktopPoolRequest request)
DesktopService
Modifies the configuration of the desktop pool such as the availability, contact information, description, name, device policy, pool size, standby size, and start or stop time.
updateDesktopPool
in interface DesktopService
request
- The request object containing the details to sendpublic DesktopServiceWaiters getWaiters()
DesktopService
Gets the pre-configured waiters available for resources for this service.
getWaiters
in interface DesktopService
public DesktopServicePaginators getPaginators()
DesktopService
Gets the pre-configured paginators available for list operations in this service which may
return multiple pages of data. These paginators provide an Iterable
interface so that service responses, or resources/records, can be iterated through without
having to manually deal with pagination and page tokens.
getPaginators
in interface DesktopService
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()
Copyright © 2016–2024. All rights reserved.