Class KmsVaultClient
- java.lang.Object
-
- com.oracle.bmc.http.internal.BaseSyncClient
-
- com.oracle.bmc.keymanagement.KmsVaultClient
-
- All Implemented Interfaces:
KmsVault
,AutoCloseable
@Generated(value="OracleSDKGenerator", comments="API Version: release") public class KmsVaultClient extends BaseSyncClient implements KmsVault
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
KmsVaultClient.Builder
Builder class for this client.
-
Field Summary
Fields Modifier and Type Field 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 KmsVault.
-
Constructor Summary
Constructors Constructor Description KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Deprecated.Use thebuilder
instead.KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Deprecated.Use thebuilder
instead.KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilder
instead.KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilder
instead.KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
Deprecated.Use thebuilder
instead.KmsVaultClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.Use thebuilder
instead.KmsVaultClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Deprecated.Use thebuilder
instead.KmsVaultClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Deprecated.Use thebuilder
instead.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description BackupVaultResponse
backupVault(BackupVaultRequest request)
Backs up an encrypted file that contains all the metadata of a vault so that you can restore the vault later.static KmsVaultClient.Builder
builder()
Create a builder for this client.CancelVaultDeletionResponse
cancelVaultDeletion(CancelVaultDeletionRequest request)
Cancels the scheduled deletion of the specified vault.ChangeVaultCompartmentResponse
changeVaultCompartment(ChangeVaultCompartmentRequest request)
Moves a vault into a different compartment within the same tenancy.void
close()
CreateVaultResponse
createVault(CreateVaultRequest request)
Creates a new vault.CreateVaultReplicaResponse
createVaultReplica(CreateVaultReplicaRequest request)
Creates a replica for the vault in another region in the same realmDeleteVaultReplicaResponse
deleteVaultReplica(DeleteVaultReplicaRequest request)
Deletes a vault replicaString
getClientCommonLibraryVersion()
protected ClientConfigurator
getDefaultConfigurator()
String
getEndpoint()
Optional<String>
getMinimumClientCommonLibraryVersionFromClient()
KmsVaultPaginators
getPaginators()
Gets the pre-configured paginators available for list operations in this service which may return multiple pages of data.GetVaultResponse
getVault(GetVaultRequest request)
Gets the specified vault’s configuration information.GetVaultUsageResponse
getVaultUsage(GetVaultUsageRequest request)
Gets the count of keys and key versions in the specified vault to calculate usage against service limits.KmsVaultWaiters
getWaiters()
Gets the pre-configured waiters available for resources for this service.ListVaultReplicasResponse
listVaultReplicas(ListVaultReplicasRequest request)
Lists the replicas for a vaultListVaultsResponse
listVaults(ListVaultsRequest request)
Lists the vaults in the specified 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 backingHttpClient
.RestoreVaultFromFileResponse
restoreVaultFromFile(RestoreVaultFromFileRequest request)
Restores a vault from an encrypted backup file.RestoreVaultFromObjectStoreResponse
restoreVaultFromObjectStore(RestoreVaultFromObjectStoreRequest request)
Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object Storage.ScheduleVaultDeletionResponse
scheduleVaultDeletion(ScheduleVaultDeletionRequest request)
Schedules the deletion of the specified vault.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’).void
updateBaseEndpoint(String endpoint)
This method should be used for parameterized endpoint templates only.UpdateVaultResponse
updateVault(UpdateVaultRequest request)
Updates the properties of a vault.void
useRealmSpecificEndpointTemplate(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.keymanagement.KmsVault
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
-
-
-
-
Constructor Detail
-
KmsVaultClient
@Deprecated public KmsVaultClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)
-
KmsVaultClient
@Deprecated public KmsVaultClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
-ClientBuilderBase.configuration
-
KmsVaultClient
@Deprecated public KmsVaultClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
-ClientBuilderBase.configuration
clientConfigurator
-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
-
KmsVaultClient
@Deprecated public KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
-ClientBuilderBase.configuration
clientConfigurator
-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
-ClientBuilderBase.requestSignerFactory
-
KmsVaultClient
@Deprecated public KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
-ClientBuilderBase.configuration
clientConfigurator
-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
-ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
-ClientBuilderBase.additionalClientConfigurators
-
KmsVaultClient
@Deprecated public KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.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)
-
KmsVaultClient
@Deprecated public KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.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
-
KmsVaultClient
@Deprecated public KmsVaultClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
Deprecated.Use thebuilder
instead.Create a new client instance.- Parameters:
authenticationDetailsProvider
- The authentication details (seeKmsVaultClient.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
-KmsVaultClient.Builder.executorService
-
-
Method Detail
-
builder
public static KmsVaultClient.Builder builder()
Create a builder for this client.- Returns:
- builder
-
setRegion
public void setRegion(Region region)
Description copied from interface:KmsVault
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
public void setRegion(String regionId)
Description copied from interface:KmsVault
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 callsetEndpoint
.
-
backupVault
public BackupVaultResponse backupVault(BackupVaultRequest request)
Description copied from interface:KmsVault
Backs up an encrypted file that contains all the metadata of a vault so that you can restore the vault later.You can backup a vault whether or not it contains keys. This operation only backs up the metadata of the vault, and does not include key metadata.
- Specified by:
backupVault
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
cancelVaultDeletion
public CancelVaultDeletionResponse cancelVaultDeletion(CancelVaultDeletionRequest request)
Description copied from interface:KmsVault
Cancels the scheduled deletion of the specified vault.Canceling a scheduled deletion restores the vault and all keys in it to their respective states from before their scheduled deletion. All keys that were scheduled for deletion prior to vault deletion retain their lifecycle state and time of deletion.
As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
cancelVaultDeletion
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
changeVaultCompartment
public ChangeVaultCompartmentResponse changeVaultCompartment(ChangeVaultCompartmentRequest request)
Description copied from interface:KmsVault
Moves a vault into a different compartment within the same tenancy.For information about moving resources between compartments, see Moving Resources to a Different Compartment.
When provided, if-match is checked against the ETag values of the resource.
As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
changeVaultCompartment
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createVault
public CreateVaultResponse createVault(CreateVaultRequest request)
Description copied from interface:KmsVault
Creates a new vault.The type of vault you create determines key placement, pricing, and available options. Options include storage isolation, a dedicated service endpoint instead of a shared service endpoint for API calls, and either a dedicated hardware security module (HSM) or a multitenant HSM.
As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
createVault
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createVaultReplica
public CreateVaultReplicaResponse createVaultReplica(CreateVaultReplicaRequest request)
Description copied from interface:KmsVault
Creates a replica for the vault in another region in the same realmThe API is a no-op if called for same region that a vault is already replicated to. 409 if called on a vault that is already replicated to a different region. Users need to delete existing replica first before calling it with a different region.
As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
createVaultReplica
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteVaultReplica
public DeleteVaultReplicaResponse deleteVaultReplica(DeleteVaultReplicaRequest request)
Description copied from interface:KmsVault
Deletes a vault replicaAs a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
deleteVaultReplica
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getVault
public GetVaultResponse getVault(GetVaultRequest request)
Description copied from interface:KmsVault
Gets the specified vault’s configuration information.As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning read operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning read operations exceeds 10 requests per second for a given tenancy.
-
getVaultUsage
public GetVaultUsageResponse getVaultUsage(GetVaultUsageRequest request)
Description copied from interface:KmsVault
Gets the count of keys and key versions in the specified vault to calculate usage against service limits.- Specified by:
getVaultUsage
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listVaultReplicas
public ListVaultReplicasResponse listVaultReplicas(ListVaultReplicasRequest request)
Description copied from interface:KmsVault
Lists the replicas for a vaultAs a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
listVaultReplicas
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listVaults
public ListVaultsResponse listVaults(ListVaultsRequest request)
Description copied from interface:KmsVault
Lists the vaults in the specified compartment.As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning read operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning read operations exceeds 10 requests per second for a given tenancy.
- Specified by:
listVaults
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
restoreVaultFromFile
public RestoreVaultFromFileResponse restoreVaultFromFile(RestoreVaultFromFileRequest request)
Description copied from interface:KmsVault
Restores a vault from an encrypted backup file.If a vault with the same OCID already exists, this operation returns a response with a 409 HTTP status error code.
Note: This operation consumes a stream.
If the stream supports
InputStream.mark(int)
andInputStream.reset()
, when a retry is necessary, the stream is reset so it starts at the beginning (or whatever the stream's position was at the time this operation is called}.Note this means that if the caller has used
InputStream.mark(int)
before, then the mark will not be the same anymore after this operation, and a subsequent call toInputStream.reset()
by the caller will reset the stream not to the caller's mark, but to the position the stream was in when this operation was called.If the stream is a
FileInputStream
, and the stream'sFileChannel
position can be changed (like for a regular file), the stream will be wrapped in such a way that it does provide support forInputStream.mark(int)
andInputStream.reset()
. Then the same procedure as above is followed. If the stream'sFileChannel
position cannot be changed (like for a named pipe), then the stream's contents will be buffered in memory, as described below.If the stream does not support
InputStream.mark(int)
andInputStream.reset()
, then the stream is wrapped in aBufferedInputStream
, which means the entire contents may be buffered in memory. Then the same procedure as above is followed.The contents of the stream, except when the stream is a
FileInputStream
whoseFileChannel
position can be changed, should be less than 2 GiB in size if retries are used. This is because streams 2 GiB in size or larger do no guarantee that mark-and-reset can be performed. If the stream is larger, do not use built-in retries and manage retries yourself.- Specified by:
restoreVaultFromFile
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
restoreVaultFromObjectStore
public RestoreVaultFromObjectStoreResponse restoreVaultFromObjectStore(RestoreVaultFromObjectStoreRequest request)
Description copied from interface:KmsVault
Restores a vault from an encrypted backup file stored in Oracle Cloud Infrastructure Object Storage.If a vault with the same OCID already exists, this operation returns a response with a 409 HTTP status error code.
- Specified by:
restoreVaultFromObjectStore
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
scheduleVaultDeletion
public ScheduleVaultDeletionResponse scheduleVaultDeletion(ScheduleVaultDeletionRequest request)
Description copied from interface:KmsVault
Schedules the deletion of the specified vault.This sets the lifecycle state of the vault and all keys in it that are not already scheduled for deletion to
PENDING_DELETION
and then deletes them after the retention period ends. The lifecycle state and time of deletion for keys already scheduled for deletion won’t change. If any keys in the vault are scheduled to be deleted after the specified time of deletion for the vault, the call is rejected with the error code 409.As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
scheduleVaultDeletion
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
updateVault
public UpdateVaultResponse updateVault(UpdateVaultRequest request)
Description copied from interface:KmsVault
Updates the properties of a vault.Specifically, you can update the
displayName
,freeformTags
, anddefinedTags
properties. Furthermore, the vault must be in an ACTIVE or CREATING state to be updated.As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy.
- Specified by:
updateVault
in interfaceKmsVault
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getWaiters
public KmsVaultWaiters getWaiters()
Description copied from interface:KmsVault
Gets the pre-configured waiters available for resources for this service.- Specified by:
getWaiters
in interfaceKmsVault
- Returns:
- The service waiters.
-
getPaginators
public KmsVaultPaginators getPaginators()
Description copied from interface:KmsVault
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.- Specified by:
getPaginators
in interfaceKmsVault
- Returns:
- The service paginators.
-
getDefaultConfigurator
protected ClientConfigurator getDefaultConfigurator()
-
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
-
populateServiceParametersInEndpoint
public final void populateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap)
Populate the parameters in the endpoint with its corresponding value and update the base endpoint.The value will be populated iff the parameter in endpoint is a required request path parameter or a required request query parameter. If not, the parameter in the endpoint will be ignored and left blank.
- Parameters:
endpoint
- The endpoint template in userequiredParametersMap
- Map of parameter name as key and value set in request path or query parameter as value
-
updateBaseEndpoint
public final void updateBaseEndpoint(String endpoint)
This method should be used for parameterized endpoint templates only.This does not include {region} and {secondLevelDomain} parameters.
- Parameters:
endpoint
- The updated endpoint to use
-
setEndpoint
public final void setEndpoint(String endpoint)
-
getEndpoint
public final String getEndpoint()
-
refreshClient
public final void refreshClient()
Rebuild the backingHttpClient
.This will call
ClientConfigurator
s again, and can be used to e.g. refresh the SSL certificate.
-
close
public final void close()
- Specified by:
close
in interfaceAutoCloseable
-
getClientCommonLibraryVersion
public String getClientCommonLibraryVersion()
-
-