Class GenerativeAiSandboxClient
- java.lang.Object
-
- com.oracle.bmc.http.internal.BaseSyncClient
-
- com.oracle.bmc.generativeaisandbox.GenerativeAiSandboxClient
-
- All Implemented Interfaces:
GenerativeAiSandbox,AutoCloseable
@Generated(value="OracleSDKGenerator", comments="API Version: 1.0") public class GenerativeAiSandboxClient extends BaseSyncClient implements GenerativeAiSandbox
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classGenerativeAiSandboxClient.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 GenerativeAiSandbox.
-
Constructor Summary
Constructors Constructor Description GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)Deprecated.Use thebuilderinstead.GenerativeAiSandboxClient(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 GenerativeAiSandboxClient.Builderbuilder()Create a builder for this client.CancelSandboxCommandResponsecancelSandboxCommand(CancelSandboxCommandRequest request)Requests cancellation of a running sandbox command.voidclose()CreateSandboxResponsecreateSandbox(CreateSandboxRequest request)Creates a sandbox resource and returns its initial state.CreateSandboxSnapshotResponsecreateSandboxSnapshot(CreateSandboxSnapshotRequest request)Creates a sandbox snapshot resource and returns its initial state.DeleteSandboxResponsedeleteSandbox(DeleteSandboxRequest request)Deletes a sandbox.DeleteSandboxSnapshotResponsedeleteSandboxSnapshot(DeleteSandboxSnapshotRequest request)Deletes a sandbox snapshot.voidenableDualStackEndpoints(boolean enableDualStackEndpoints)This method should be used to enable or disable the use of dual-stack endpoints.ExtendSandboxResponseextendSandbox(ExtendSandboxRequest request)Extends the duration of a sandbox.StringgetClientCommonLibraryVersion()protected ClientConfiguratorgetDefaultConfigurator()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.GenerativeAiSandboxPaginatorsgetPaginators()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.GetSandboxResponsegetSandbox(GetSandboxRequest request)Gets information about a sandbox.GetSandboxCommandResponsegetSandboxCommand(GetSandboxCommandRequest request)Gets command metadata for a sandbox command.GetSandboxCommandOutputResponsegetSandboxCommandOutput(GetSandboxCommandOutputRequest request)Gets captured output for a sandbox command starting from the requested event sequence.GetSandboxSnapshotResponsegetSandboxSnapshot(GetSandboxSnapshotRequest request)Gets information about a sandbox snapshot.GenerativeAiSandboxWaitersgetWaiters()Gets the pre-configured waiters available for resources for this service.ListSandboxCommandResponselistSandboxCommand(ListSandboxCommandRequest request)Lists sandbox commands for a sandbox with optional pagination.ListSandboxesResponselistSandboxes(ListSandboxesRequest request)Lists sandbox resources with optional filtering and pagination.ListSandboxSnapshotsResponselistSandboxSnapshots(ListSandboxSnapshotsRequest request)Lists sandbox snapshot resources with optional filtering and pagination.ReadSandboxFileResponsereadSandboxFile(ReadSandboxFileRequest request)Reads a file from a sandbox.voidrefreshClient()Rebuild the backingHttpClient.ResumeSandboxResponseresumeSandbox(ResumeSandboxRequest request)Resumes a suspended sandbox by scaling its backing runtime back to one replica.RunSandboxCommandResponserunSandboxCommand(RunSandboxCommandRequest request)Runs a command in a sandbox and returns the command identifier immediately.RunSandboxCommandAndStreamResponserunSandboxCommandAndStream(RunSandboxCommandAndStreamRequest request)Runs a command in a sandbox and streams command events as newline-delimited JSON.RunSandboxCommandAndWaitResponserunSandboxCommandAndWait(RunSandboxCommandAndWaitRequest request)Runs a command in a sandbox, blocks until command execution finishes, and returns the final command metadata.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’).StopSandboxResponsestopSandbox(StopSandboxRequest request)Stops a running sandbox.StreamSandboxCommandEventsResponsestreamSandboxCommandEvents(StreamSandboxCommandEventsRequest request)Streams command events for an existing sandbox command fromfromSeqthroughuntilSequsing Server-Sent Events.SuspendSandboxResponsesuspendSandbox(SuspendSandboxRequest request)Suspends a running sandbox by scaling its backing runtime to zero replicas while retaining the workspace block volume.UpdateSandboxResponseupdateSandbox(UpdateSandboxRequest request)Updates a sandbox.voiduseRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)This method should be used to enable or disable the use of realm-specific endpoint template.WriteSandboxFileResponsewriteSandboxFile(WriteSandboxFileRequest request)Writes a file in a sandbox and returns the resulting file resource.-
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.generativeaisandbox.GenerativeAiSandbox
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
-
-
-
-
Constructor Detail
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeGenerativeAiSandboxClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeGenerativeAiSandboxClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configuration
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeGenerativeAiSandboxClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeGenerativeAiSandboxClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactory
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Deprecated.Use thebuilderinstead.Create a new client instance.- Parameters:
authenticationDetailsProvider- The authentication details (seeGenerativeAiSandboxClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider))configuration-ClientBuilderBase.configurationclientConfigurator-ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)defaultRequestSignerFactory-ClientBuilderBase.requestSignerFactoryadditionalClientConfigurators-ClientBuilderBase.additionalClientConfigurators
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(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 (seeGenerativeAiSandboxClient.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)
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(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 (seeGenerativeAiSandboxClient.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
-
GenerativeAiSandboxClient
@Deprecated public GenerativeAiSandboxClient(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 (seeGenerativeAiSandboxClient.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-GenerativeAiSandboxClient.Builder.executorService
-
-
Method Detail
-
builder
public static GenerativeAiSandboxClient.Builder builder()
Create a builder for this client.- Returns:
- builder
-
setRegion
public void setRegion(Region region)
Description copied from interface:GenerativeAiSandboxSets 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 interfaceGenerativeAiSandbox- Parameters:
region- The region of the service.
-
setRegion
public void setRegion(String regionId)
Description copied from interface:GenerativeAiSandboxSets 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 interfaceGenerativeAiSandbox- Parameters:
regionId- The public region ID.
-
cancelSandboxCommand
public CancelSandboxCommandResponse cancelSandboxCommand(CancelSandboxCommandRequest request)
Description copied from interface:GenerativeAiSandboxRequests cancellation of a running sandbox command.- Specified by:
cancelSandboxCommandin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createSandbox
public CreateSandboxResponse createSandbox(CreateSandboxRequest request)
Description copied from interface:GenerativeAiSandboxCreates a sandbox resource and returns its initial state.- Specified by:
createSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
createSandboxSnapshot
public CreateSandboxSnapshotResponse createSandboxSnapshot(CreateSandboxSnapshotRequest request)
Description copied from interface:GenerativeAiSandboxCreates a sandbox snapshot resource and returns its initial state.- Specified by:
createSandboxSnapshotin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteSandbox
public DeleteSandboxResponse deleteSandbox(DeleteSandboxRequest request)
Description copied from interface:GenerativeAiSandboxDeletes a sandbox.- Specified by:
deleteSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
deleteSandboxSnapshot
public DeleteSandboxSnapshotResponse deleteSandboxSnapshot(DeleteSandboxSnapshotRequest request)
Description copied from interface:GenerativeAiSandboxDeletes a sandbox snapshot.- Specified by:
deleteSandboxSnapshotin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
extendSandbox
public ExtendSandboxResponse extendSandbox(ExtendSandboxRequest request)
Description copied from interface:GenerativeAiSandboxExtends the duration of a sandbox.- Specified by:
extendSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getSandbox
public GetSandboxResponse getSandbox(GetSandboxRequest request)
Description copied from interface:GenerativeAiSandboxGets information about a sandbox.- Specified by:
getSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getSandboxCommand
public GetSandboxCommandResponse getSandboxCommand(GetSandboxCommandRequest request)
Description copied from interface:GenerativeAiSandboxGets command metadata for a sandbox command.- Specified by:
getSandboxCommandin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getSandboxCommandOutput
public GetSandboxCommandOutputResponse getSandboxCommandOutput(GetSandboxCommandOutputRequest request)
Description copied from interface:GenerativeAiSandboxGets captured output for a sandbox command starting from the requested event sequence.- Specified by:
getSandboxCommandOutputin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getSandboxSnapshot
public GetSandboxSnapshotResponse getSandboxSnapshot(GetSandboxSnapshotRequest request)
Description copied from interface:GenerativeAiSandboxGets information about a sandbox snapshot.- Specified by:
getSandboxSnapshotin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listSandboxCommand
public ListSandboxCommandResponse listSandboxCommand(ListSandboxCommandRequest request)
Description copied from interface:GenerativeAiSandboxLists sandbox commands for a sandbox with optional pagination.- Specified by:
listSandboxCommandin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listSandboxSnapshots
public ListSandboxSnapshotsResponse listSandboxSnapshots(ListSandboxSnapshotsRequest request)
Description copied from interface:GenerativeAiSandboxLists sandbox snapshot resources with optional filtering and pagination.- Specified by:
listSandboxSnapshotsin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
listSandboxes
public ListSandboxesResponse listSandboxes(ListSandboxesRequest request)
Description copied from interface:GenerativeAiSandboxLists sandbox resources with optional filtering and pagination.Specify exactly one of
projectIdorcompartmentId. A compartment-scoped request returns sandboxes from Generative AI projects directly contained in that compartment; child compartments are not included.- Specified by:
listSandboxesin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
readSandboxFile
public ReadSandboxFileResponse readSandboxFile(ReadSandboxFileRequest request)
Description copied from interface:GenerativeAiSandboxReads a file from a sandbox.- Specified by:
readSandboxFilein interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
resumeSandbox
public ResumeSandboxResponse resumeSandbox(ResumeSandboxRequest request)
Description copied from interface:GenerativeAiSandboxResumes a suspended sandbox by scaling its backing runtime back to one replica.- Specified by:
resumeSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
runSandboxCommand
public RunSandboxCommandResponse runSandboxCommand(RunSandboxCommandRequest request)
Description copied from interface:GenerativeAiSandboxRuns a command in a sandbox and returns the command identifier immediately.- Specified by:
runSandboxCommandin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
runSandboxCommandAndStream
public RunSandboxCommandAndStreamResponse runSandboxCommandAndStream(RunSandboxCommandAndStreamRequest request)
Description copied from interface:GenerativeAiSandboxRuns a command in a sandbox and streams command events as newline-delimited JSON.Each line is a serialized SandboxCommandEvent.
- Specified by:
runSandboxCommandAndStreamin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
runSandboxCommandAndWait
public RunSandboxCommandAndWaitResponse runSandboxCommandAndWait(RunSandboxCommandAndWaitRequest request)
Description copied from interface:GenerativeAiSandboxRuns a command in a sandbox, blocks until command execution finishes, and returns the final command metadata.- Specified by:
runSandboxCommandAndWaitin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
stopSandbox
public StopSandboxResponse stopSandbox(StopSandboxRequest request)
Description copied from interface:GenerativeAiSandboxStops a running sandbox.- Specified by:
stopSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
streamSandboxCommandEvents
public StreamSandboxCommandEventsResponse streamSandboxCommandEvents(StreamSandboxCommandEventsRequest request)
Description copied from interface:GenerativeAiSandboxStreams command events for an existing sandbox command fromfromSeqthroughuntilSequsing Server-Sent Events.Each SSE
datafield contains a serialized SandboxCommandEvent.- Specified by:
streamSandboxCommandEventsin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
suspendSandbox
public SuspendSandboxResponse suspendSandbox(SuspendSandboxRequest request)
Description copied from interface:GenerativeAiSandboxSuspends a running sandbox by scaling its backing runtime to zero replicas while retaining the workspace block volume.- Specified by:
suspendSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
updateSandbox
public UpdateSandboxResponse updateSandbox(UpdateSandboxRequest request)
Description copied from interface:GenerativeAiSandboxUpdates a sandbox.- Specified by:
updateSandboxin interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
writeSandboxFile
public WriteSandboxFileResponse writeSandboxFile(WriteSandboxFileRequest request)
Description copied from interface:GenerativeAiSandboxWrites a file in a sandbox and returns the resulting file resource.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'sFileChannelposition 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'sFileChannelposition 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
FileInputStreamwhoseFileChannelposition 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:
writeSandboxFilein interfaceGenerativeAiSandbox- Parameters:
request- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
-
getWaiters
public GenerativeAiSandboxWaiters getWaiters()
Description copied from interface:GenerativeAiSandboxGets the pre-configured waiters available for resources for this service.- Specified by:
getWaitersin interfaceGenerativeAiSandbox- Returns:
- The service waiters.
-
getPaginators
public GenerativeAiSandboxPaginators getPaginators()
Description copied from interface:GenerativeAiSandboxGets 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 interfaceGenerativeAiSandbox- 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()
-
-