Class DesktopServiceClient
- java.lang.Object
-
- com.oracle.bmc.http.internal.BaseSyncClient
-
- com.oracle.bmc.desktops.DesktopServiceClient
-
- All Implemented Interfaces:
DesktopService,AutoCloseable
@Generated(value="OracleSDKGenerator", comments="API Version: 20220618") public class DesktopServiceClient extends BaseSyncClient implements DesktopService
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classDesktopServiceClient.BuilderBuilder class for this client.
-
Field Summary
Fields Modifier and Type Field Description StringclientCommonLibraryVersionCompatible SDK version, provided by the codegen.Optional<String>minimumClientCommonLibraryVersionFromClientMinimum compatible SDK version, maybe provided by the codegen.static ServiceSERVICEService instance for DesktopService.
-
Constructor Summary
Constructors Constructor Description DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)Deprecated.Use thebuilderinstead.DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)Deprecated.Use thebuilderinstead.DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)Deprecated.Use thebuilderinstead.DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)Deprecated.Use thebuilderinstead.DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)Deprecated.Use thebuilderinstead.DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)Deprecated.Use thebuilderinstead.DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)Deprecated.Use thebuilderinstead.DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)Deprecated.Use thebuilderinstead.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static DesktopServiceClient.Builderbuilder()Create a builder for this client.CancelWorkRequestResponsecancelWorkRequest(CancelWorkRequestRequest request)Cancel work request with the given ID.ChangeDesktopPoolCompartmentResponsechangeDesktopPoolCompartment(ChangeDesktopPoolCompartmentRequest request)Moves a desktop pool into a different compartment within the same tenancy.voidclose()CreateDesktopPoolResponsecreateDesktopPool(CreateDesktopPoolRequest request)Creates a desktop pool with the given configuration parameters.DeleteDesktopResponsedeleteDesktop(DeleteDesktopRequest request)Deletes the desktop with the specified OCID.DeleteDesktopPoolResponsedeleteDesktopPool(DeleteDesktopPoolRequest request)Deletes a desktop pool with the specified OCID.voidenableDualStackEndpoints(boolean enableDualStackEndpoints)This method should be used to enable or disable the use of dual-stack endpoints.StringgetClientCommonLibraryVersion()protected ClientConfiguratorgetDefaultConfigurator()GetDesktopResponsegetDesktop(GetDesktopRequest request)Provides information about the desktop with the specified OCID.GetDesktopPoolResponsegetDesktopPool(GetDesktopPoolRequest request)Returns information about the desktop pool including all configuration parameters and the current state.StringgetEndpoint()Get the endpoint of the client.Optional<String>getMinimumClientCommonLibraryVersionFromClient()Map<String,Boolean>getOptionsMap()Return an immutable snapshot representing the current options set for this client.DesktopServicePaginatorsgetPaginators()Gets the pre-configured paginators available for list operations in this service which may return multiple pages of data.StringgetResolvedEndpoint(Map<String,Object> requiredParametersMap)Returns the endpoint after filling in the current options, as determined byBaseClient.getOptionsMap(), and then filling in the required parameters in requiredParametersMap into the placeholders in the endpoint.DesktopServiceWaitersgetWaiters()Gets the pre-configured waiters available for resources for this service.GetWorkRequestResponsegetWorkRequest(GetWorkRequestRequest request)Gets the status of the work request with the given ID.ListDesktopPoolDesktopsResponselistDesktopPoolDesktops(ListDesktopPoolDesktopsRequest request)Returns a list of desktops within a given desktop pool.ListDesktopPoolsResponselistDesktopPools(ListDesktopPoolsRequest request)Returns a list of desktop pools within the given compartment.ListDesktopPoolVolumesResponselistDesktopPoolVolumes(ListDesktopPoolVolumesRequest request)Returns a list of volumes within the given desktop pool.ListDesktopsResponselistDesktops(ListDesktopsRequest request)Returns a list of desktops filtered by the specified parameters.ListWorkRequestErrorsResponselistWorkRequestErrors(ListWorkRequestErrorsRequest request)Return a (paginated) list of errors for a given work request.ListWorkRequestLogsResponselistWorkRequestLogs(ListWorkRequestLogsRequest request)Return a (paginated) list of logs for a given work request.ListWorkRequestsResponselistWorkRequests(ListWorkRequestsRequest request)Lists the work requests in a compartment.voidrefreshClient()Rebuild the backingHttpClient.voidsetEndpoint(String endpoint)voidsetRegion(Region region)Sets the region to call (ex, Region.US_PHOENIX_1).voidsetRegion(String regionId)Sets the region to call (ex, ‘us-phoenix-1’).StartDesktopResponsestartDesktop(StartDesktopRequest request)Starts the desktop with the specified OCID.StartDesktopPoolResponsestartDesktopPool(StartDesktopPoolRequest request)Starts the desktop pool with the specified OCID.StopDesktopResponsestopDesktop(StopDesktopRequest request)Stops the desktop with the specified OCID.StopDesktopPoolResponsestopDesktopPool(StopDesktopPoolRequest request)Stops the desktop pool with the specified OCID.UpdateDesktopResponseupdateDesktop(UpdateDesktopRequest request)Modifies information about the desktop such as the name.UpdateDesktopPoolResponseupdateDesktopPool(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.voiduseRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)This method should be used to enable or disable the use of realm-specific endpoint template.-
Methods inherited from class com.oracle.bmc.http.internal.BaseSyncClient
clientCall
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.lang.AutoCloseable
close
-
Methods inherited from interface com.oracle.bmc.desktops.DesktopService
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
-
-
-
-
Constructor Detail
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configuration
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactory
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfigurators
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfiguratorsendpoint-ClientBuilderBase.endpoint(java.lang.String)
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfiguratorsendpoint-ClientBuilderBase.endpoint(java.lang.String)signingStrategyRequestSignerFactories-ClientBuilderBase.signingStrategyRequestSignerFactories
-
DesktopServiceClient
@Deprecated public DesktopServiceClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeDesktopServiceClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfiguratorsendpoint-ClientBuilderBase.endpoint(java.lang.String)signingStrategyRequestSignerFactories-ClientBuilderBase.signingStrategyRequestSignerFactoriesexecutorService-DesktopServiceClient.Builder.executorService
-
-
Method Detail
-
builder
public static DesktopServiceClient.Builder builder()
Create a builder for this client.- Returns:
- builder
-
setRegion
public void setRegion(Region region)
Description copied from interface:DesktopServiceSets the region to call (ex, Region.US_PHOENIX_1).Note, this will call
setEndpointafter resolving the endpoint. If the service is not available in this Region, however, an IllegalArgumentException will be raised.- Specified by:
setRegionin interfaceDesktopService- Parameters:
region- The region of the service.
-
setRegion
public void setRegion(String regionId)
Description copied from interface:DesktopServiceSets 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 callsetEndpoint.- Specified by:
setRegionin interfaceDesktopService- Parameters:
regionId- The public region ID.
-
cancelWorkRequest
public CancelWorkRequestResponse cancelWorkRequest(CancelWorkRequestRequest request)
Description copied from interface:DesktopServiceCancel work request with the given ID.- Specified by:
cancelWorkRequestin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
changeDesktopPoolCompartment
public ChangeDesktopPoolCompartmentResponse changeDesktopPoolCompartment(ChangeDesktopPoolCompartmentRequest request)
Description copied from interface:DesktopServiceMoves 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.
- Specified by:
changeDesktopPoolCompartmentin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createDesktopPool
public CreateDesktopPoolResponse createDesktopPool(CreateDesktopPoolRequest request)
Description copied from interface:DesktopServiceCreates a desktop pool with the given configuration parameters.- Specified by:
createDesktopPoolin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteDesktop
public DeleteDesktopResponse deleteDesktop(DeleteDesktopRequest request)
Description copied from interface:DesktopServiceDeletes 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.
- Specified by:
deleteDesktopin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteDesktopPool
public DeleteDesktopPoolResponse deleteDesktopPool(DeleteDesktopPoolRequest request)
Description copied from interface:DesktopServiceDeletes 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.
- Specified by:
deleteDesktopPoolin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getDesktop
public GetDesktopResponse getDesktop(GetDesktopRequest request)
Description copied from interface:DesktopServiceProvides information about the desktop with the specified OCID.- Specified by:
getDesktopin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getDesktopPool
public GetDesktopPoolResponse getDesktopPool(GetDesktopPoolRequest request)
Description copied from interface:DesktopServiceReturns information about the desktop pool including all configuration parameters and the current state.- Specified by:
getDesktopPoolin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getWorkRequest
public GetWorkRequestResponse getWorkRequest(GetWorkRequestRequest request)
Description copied from interface:DesktopServiceGets the status of the work request with the given ID.- Specified by:
getWorkRequestin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listDesktopPoolDesktops
public ListDesktopPoolDesktopsResponse listDesktopPoolDesktops(ListDesktopPoolDesktopsRequest request)
Description copied from interface:DesktopServiceReturns 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.
- Specified by:
listDesktopPoolDesktopsin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listDesktopPoolVolumes
public ListDesktopPoolVolumesResponse listDesktopPoolVolumes(ListDesktopPoolVolumesRequest request)
Description copied from interface:DesktopServiceReturns 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.
- Specified by:
listDesktopPoolVolumesin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listDesktopPools
public ListDesktopPoolsResponse listDesktopPools(ListDesktopPoolsRequest request)
Description copied from interface:DesktopServiceReturns 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.
- Specified by:
listDesktopPoolsin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listDesktops
public ListDesktopsResponse listDesktops(ListDesktopsRequest request)
Description copied from interface:DesktopServiceReturns 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.
- Specified by:
listDesktopsin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listWorkRequestErrors
public ListWorkRequestErrorsResponse listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Description copied from interface:DesktopServiceReturn a (paginated) list of errors for a given work request.- Specified by:
listWorkRequestErrorsin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listWorkRequestLogs
public ListWorkRequestLogsResponse listWorkRequestLogs(ListWorkRequestLogsRequest request)
Description copied from interface:DesktopServiceReturn a (paginated) list of logs for a given work request.- Specified by:
listWorkRequestLogsin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listWorkRequests
public ListWorkRequestsResponse listWorkRequests(ListWorkRequestsRequest request)
Description copied from interface:DesktopServiceLists the work requests in a compartment.- Specified by:
listWorkRequestsin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
startDesktop
public StartDesktopResponse startDesktop(StartDesktopRequest request)
Description copied from interface:DesktopServiceStarts the desktop with the specified OCID.- Specified by:
startDesktopin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
startDesktopPool
public StartDesktopPoolResponse startDesktopPool(StartDesktopPoolRequest request)
Description copied from interface:DesktopServiceStarts the desktop pool with the specified OCID.Once the pool is ACTIVE, users will have access to their desktops within the pool.
- Specified by:
startDesktopPoolin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
stopDesktop
public StopDesktopResponse stopDesktop(StopDesktopRequest request)
Description copied from interface:DesktopServiceStops 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.
- Specified by:
stopDesktopin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
stopDesktopPool
public StopDesktopPoolResponse stopDesktopPool(StopDesktopPoolRequest request)
Description copied from interface:DesktopServiceStops the desktop pool with the specified OCID.Users will lose access to their desktops until you explicitly start the pool again.
- Specified by:
stopDesktopPoolin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
updateDesktop
public UpdateDesktopResponse updateDesktop(UpdateDesktopRequest request)
Description copied from interface:DesktopServiceModifies information about the desktop such as the name.- Specified by:
updateDesktopin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
updateDesktopPool
public UpdateDesktopPoolResponse updateDesktopPool(UpdateDesktopPoolRequest request)
Description copied from interface:DesktopServiceModifies 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.- Specified by:
updateDesktopPoolin interfaceDesktopService- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getWaiters
public DesktopServiceWaiters getWaiters()
Description copied from interface:DesktopServiceGets the pre-configured waiters available for resources for this service.- Specified by:
getWaitersin interfaceDesktopService- Returns:
- The service waiters.
-
getPaginators
public DesktopServicePaginators getPaginators()
Description copied from interface:DesktopServiceGets the pre-configured paginators available for list operations in this service which may return multiple pages of data.These paginators provide an
Iterableinterface so that service responses, or resources/records, can be iterated through without having to manually deal with pagination and page tokens.- Specified by:
getPaginatorsin interfaceDesktopService- Returns:
- The service paginators.
-
getDefaultConfigurator
protected ClientConfigurator getDefaultConfigurator()
-
enableDualStackEndpoints
public void enableDualStackEndpoints(boolean enableDualStackEndpoints)
This method should be used to enable or disable the use of dual-stack endpoints.The default value is false i.e. dual-stack endpoints are disabled by default.
- Parameters:
enableDualStackEndpoints- This flag can be set to true or false to enable or disable the use of dual-stack endpoints respectively
-
getOptionsMap
public Map<String,Boolean> getOptionsMap()
Return an immutable snapshot representing the current options set for this client.- Returns:
- immutable snapshot representing the current options set for this client
-
getResolvedEndpoint
public String getResolvedEndpoint(Map<String,Object> requiredParametersMap)
Returns the endpoint after filling in the current options, as determined byBaseClient.getOptionsMap(), and then filling in the required parameters in requiredParametersMap into the placeholders in the endpoint.- Parameters:
requiredParametersMap- the map from required parameter name to their values- Returns:
- resolved endpoint, with all options and placeholders filled in
-
useRealmSpecificEndpointTemplate
public void useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
This method should be used to enable or disable the use of realm-specific endpoint template.The default value is null. To enable the use of endpoint template defined for the realm in use, set the flag to true To disable the use of endpoint template defined for the realm in use, set the flag to false
- Parameters:
useOfRealmSpecificEndpointTemplateEnabled- This flag can be set to true or false to enable or disable the use of realm-specific endpoint template respectively
-
setEndpoint
public final void setEndpoint(String endpoint)
-
getEndpoint
public final String getEndpoint()
Get the endpoint of the client.Note that the endpoint may be parameterized and contain placeholders and options. The region subdomain and realm domain will have been properly replaced already if the endpoint was selected using a
Region.Examples of endpoints this may return:
- Unparameterized endpoints
https://identity.us-phoenix-1.oci.oraclecloud.com https://identity.us-ashburn-1.oci.oraclecloud.com https://test-namespace.objectstorage.us-ashburn-1.oci.customer-oci.com - Parameterized endpoints with placeholders
https://{namespaceName+Dot}objectstorage.us-phoenix-1.oci.customer-oci.com https://{namespaceName+Dot}objectstorage.us-ashburn-1.oci.customer-oci.com - Parameterized endpoints with options
https://{dualStack?ds.:}identity.us-phoenix-1.oci.oraclecloud.com https://{dualStack?ds.:}identity.us-ashburn-1.oci.oraclecloud.com - Parameterized endpoints with placeholders and options
https://{namespaceName+Dot}{dualStack?ds.:}objectstorage.us-phoenix-1.oci.customer-oci.com https://{namespaceName+Dot}{dualStack?ds.:}objectstorage.us-ashburn-1.oci.customer-oci.com
To get the actual endpoint for a parameterized request, you can use
BaseClient.getResolvedEndpoint(Map)orParameterizedEndpointUtil.getEndpointWithPopulatedServiceParameters(String, Map, Map).- Returns:
- the endpoint being used by the client
- Unparameterized endpoints
-
refreshClient
public final void refreshClient()
Rebuild the backingHttpClient.This will call
ClientConfigurators again, and can be used to e.g. refresh the SSL certificate.
-
close
public final void close()
- Specified by:
closein interfaceAutoCloseable
-
getClientCommonLibraryVersion
public String getClientCommonLibraryVersion()
-
-