@Generated(value="OracleSDKGenerator", comments="API Version: 20220901") public class ManagedInstanceGroupClient extends BaseSyncClient implements ManagedInstanceGroup
Modifier and Type | Class and Description |
---|---|
static class |
ManagedInstanceGroupClient.Builder
Builder class for this client.
|
Modifier and Type | Field and Description |
---|---|
static Service |
SERVICE
Service instance for ManagedInstanceGroup.
|
Constructor and Description |
---|
ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint,
ExecutorService executorService)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Deprecated.
Use the
builder instead. |
ManagedInstanceGroupClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Deprecated.
Use the
builder instead. |
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 ManagedInstanceGroup.
@Deprecated public ManagedInstanceGroupClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ManagedInstanceGroupClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)@Deprecated public ManagedInstanceGroupClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ManagedInstanceGroupClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
@Deprecated public ManagedInstanceGroupClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ManagedInstanceGroupClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
@Deprecated public ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ManagedInstanceGroupClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
@Deprecated public ManagedInstanceGroupClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see ManagedInstanceGroupClient.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 ManagedInstanceGroupClient(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 ManagedInstanceGroupClient.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 ManagedInstanceGroupClient(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 ManagedInstanceGroupClient.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 ManagedInstanceGroupClient(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 ManagedInstanceGroupClient.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
- ManagedInstanceGroupClient.Builder.executorService
public static ManagedInstanceGroupClient.Builder builder()
Create a builder for this client.
public void setRegion(Region region)
ManagedInstanceGroup
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 ManagedInstanceGroup
region
- The region of the service.public void setRegion(String regionId)
ManagedInstanceGroup
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 ManagedInstanceGroup
regionId
- The public region ID.public AttachManagedInstancesToManagedInstanceGroupResponse attachManagedInstancesToManagedInstanceGroup(AttachManagedInstancesToManagedInstanceGroupRequest request)
ManagedInstanceGroup
Adds managed instances to the specified managed instance group. After the managed instances have been added, then operations can be performed on the managed instance group which will then apply to all managed instances in the group.
attachManagedInstancesToManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic AttachSoftwareSourcesToManagedInstanceGroupResponse attachSoftwareSourcesToManagedInstanceGroup(AttachSoftwareSourcesToManagedInstanceGroupRequest request)
ManagedInstanceGroup
Attaches software sources to the specified managed instance group. The software sources must be compatible with the content for the managed instance group.
attachSoftwareSourcesToManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic CreateManagedInstanceGroupResponse createManagedInstanceGroup(CreateManagedInstanceGroupRequest request)
ManagedInstanceGroup
Creates a new managed instance group.
createManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic DeleteManagedInstanceGroupResponse deleteManagedInstanceGroup(DeleteManagedInstanceGroupRequest request)
ManagedInstanceGroup
Deletes a specified managed instance group.
deleteManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic DetachManagedInstancesFromManagedInstanceGroupResponse detachManagedInstancesFromManagedInstanceGroup(DetachManagedInstancesFromManagedInstanceGroupRequest request)
ManagedInstanceGroup
Removes a managed instance from the specified managed instance group.
detachManagedInstancesFromManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic DetachSoftwareSourcesFromManagedInstanceGroupResponse detachSoftwareSourcesFromManagedInstanceGroup(DetachSoftwareSourcesFromManagedInstanceGroupRequest request)
ManagedInstanceGroup
Detaches software sources from a group.
detachSoftwareSourcesFromManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic DisableModuleStreamOnManagedInstanceGroupResponse disableModuleStreamOnManagedInstanceGroup(DisableModuleStreamOnManagedInstanceGroupRequest request)
ManagedInstanceGroup
Disables a module stream on a managed instance group. After the stream is disabled, it is no longer possible to install the profiles that are contained by the stream. All installed profiles must be removed prior to disabling a module stream.
disableModuleStreamOnManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic EnableModuleStreamOnManagedInstanceGroupResponse enableModuleStreamOnManagedInstanceGroup(EnableModuleStreamOnManagedInstanceGroupRequest request)
ManagedInstanceGroup
Enables a module stream on a managed instance group. After the stream is enabled, it is possible to install the profiles that are contained by the stream. Enabling a stream that is already enabled will succeed. Attempting to enable a different stream for a module that already has a stream enabled results in an error.
enableModuleStreamOnManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic GetManagedInstanceGroupResponse getManagedInstanceGroup(GetManagedInstanceGroupRequest request)
ManagedInstanceGroup
Gets information about the specified managed instance group.
getManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic InstallModuleStreamProfileOnManagedInstanceGroupResponse installModuleStreamProfileOnManagedInstanceGroup(InstallModuleStreamProfileOnManagedInstanceGroupRequest request)
ManagedInstanceGroup
Installs a profile for an module stream. The stream must be enabled before a profile can be installed. If a module stream defines multiple profiles, each one can be installed independently.
installModuleStreamProfileOnManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic InstallPackagesOnManagedInstanceGroupResponse installPackagesOnManagedInstanceGroup(InstallPackagesOnManagedInstanceGroupRequest request)
ManagedInstanceGroup
Installs package(s) on each managed instance in a managed instance group. The package must be compatible with the instances in the managed instance group.
installPackagesOnManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ListManagedInstanceGroupAvailableModulesResponse listManagedInstanceGroupAvailableModules(ListManagedInstanceGroupAvailableModulesRequest request)
ManagedInstanceGroup
Lists available modules that for the specified managed instance group. Filter the list against a variety of criteria including but not limited to its name.
listManagedInstanceGroupAvailableModules
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ListManagedInstanceGroupAvailablePackagesResponse listManagedInstanceGroupAvailablePackages(ListManagedInstanceGroupAvailablePackagesRequest request)
ManagedInstanceGroup
Lists available packages on the specified managed instances group. Filter the list against a variety of criteria including but not limited to the package name.
listManagedInstanceGroupAvailablePackages
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ListManagedInstanceGroupAvailableSoftwareSourcesResponse listManagedInstanceGroupAvailableSoftwareSources(ListManagedInstanceGroupAvailableSoftwareSourcesRequest request)
ManagedInstanceGroup
Lists available software sources for a specified managed instance group. Filter the list against a variety of criteria including but not limited to its name.
listManagedInstanceGroupAvailableSoftwareSources
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ListManagedInstanceGroupInstalledPackagesResponse listManagedInstanceGroupInstalledPackages(ListManagedInstanceGroupInstalledPackagesRequest request)
ManagedInstanceGroup
Lists installed packages on the specified managed instances group. Filter the list against a variety of criteria including but not limited to the package name.
listManagedInstanceGroupInstalledPackages
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ListManagedInstanceGroupModulesResponse listManagedInstanceGroupModules(ListManagedInstanceGroupModulesRequest request)
ManagedInstanceGroup
Retrieve a list of module streams, along with a summary of their status, from a managed instance group. Filters may be applied to select a subset of module streams based on the filter criteria.
The 'moduleName' attribute filters against the name of a module. It accepts strings of the
format \" The \"status\" attribute filters against the state of a module stream. Valid values are
\"ENABLED\", \"DISABLED\", and \"ACTIVE\". If the attribute is set to \"ENABLED\", only
module streams that are enabled are included in the result set. If the attribute is set to
\"DISABLED\", only module streams that are not enabled are included in the result set. If the
attribute is set to \"ACTIVE\", only module streams that are active are included in the
result set. If the attribute is not defined, the request is not subject to this filter.
When sorting by the display name, the result set is sorted first by the module name and
then by the stream name.
listManagedInstanceGroupModules
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ListManagedInstanceGroupsResponse listManagedInstanceGroups(ListManagedInstanceGroupsRequest request)
ManagedInstanceGroup
Lists managed instance groups that match the specified compartment or managed instance group OCID. Filter the list against a variety of criteria including but not limited to its name, status, architecture, and OS family.
listManagedInstanceGroups
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ManageModuleStreamsOnManagedInstanceGroupResponse manageModuleStreamsOnManagedInstanceGroup(ManageModuleStreamsOnManagedInstanceGroupRequest request)
ManagedInstanceGroup
Perform an operation involving modules, streams, and profiles on a managed instance group. Each operation may enable or disable an arbitrary amount of module streams, and install or remove an arbitrary number of module stream profiles. When the operation is complete, the state of the modules, streams, and profiles on the managed instance group will match the state indicated in the operation.
Each module stream specified in the list of module streams to enable will be in the \"ENABLED\" state upon completion of the operation. If there was already a stream of that module enabled, any work required to switch from the current stream to the new stream is performed implicitly.
Each module stream specified in the list of module streams to disable will be in the \"DISABLED\" state upon completion of the operation. Any profiles that are installed for the module stream will be removed as part of the operation.
Each module stream profile specified in the list of profiles to install will be in the \"INSTALLED\" state upon completion of the operation, indicating that any packages that are part of the profile are installed on the managed instance. If the module stream containing the profile is not enabled, it will be enabled as part of the operation. There is an exception when attempting to install a stream of a profile when another stream of the same module is enabled. It is an error to attempt to install a profile of another module stream, unless enabling the new module stream is explicitly included in this operation.
Each module stream profile specified in the list of profiles to remove will be in the \"AVAILABLE\" state upon completion of the operation. The status of packages within the profile after the operation is complete is defined by the package manager on the managed instance group.
Operations that contain one or more elements that are not allowed are rejected.
The result of this request is a work request object. The returned work request is the parent of a structure of other work requests. Taken as a whole, this structure indicates the entire set of work to be performed to complete the operation.
This interface can also be used to perform a dry run of the operation rather than committing it to a managed instance group. If a dry run is requested, the OS Management Hub service will evaluate the operation against the current module, stream, and profile state on the managed instance. It will calculate the impact of the operation on all modules, streams, and profiles on the managed instance, including those that are implicitly impacted by the operation.
The work request resulting from a dry run behaves differently than a work request resulting from a committable operation. Dry run work requests are always singletons and never have children. The impact of the operation is returned using the log and error facilities of work requests. The impact of operations that are allowed by the OS Management Hub service are communicated as one or more work request log entries. Operations that are not allowed by the OS Management Hub service are communicated as one or more work request error entries. Each entry, for either logs or errors, contains a structured message containing the results of one or more operations.
manageModuleStreamsOnManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic RemoveModuleStreamProfileFromManagedInstanceGroupResponse removeModuleStreamProfileFromManagedInstanceGroup(RemoveModuleStreamProfileFromManagedInstanceGroupRequest request)
ManagedInstanceGroup
Removes a profile for a module stream that is installed on a managed instance group. If a module stream is provided, rather than a fully qualified profile, all profiles that have been installed for the module stream will be removed.
removeModuleStreamProfileFromManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic RemovePackagesFromManagedInstanceGroupResponse removePackagesFromManagedInstanceGroup(RemovePackagesFromManagedInstanceGroupRequest request)
ManagedInstanceGroup
Removes package(s) from each managed instance in a specified managed instance group.
removePackagesFromManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic UpdateAllPackagesOnManagedInstanceGroupResponse updateAllPackagesOnManagedInstanceGroup(UpdateAllPackagesOnManagedInstanceGroupRequest request)
ManagedInstanceGroup
Updates all packages on each managed instance in the specified managed instance group.
updateAllPackagesOnManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic UpdateManagedInstanceGroupResponse updateManagedInstanceGroup(UpdateManagedInstanceGroupRequest request)
ManagedInstanceGroup
Updates the specified managed instance group’s name, description, and tags.
updateManagedInstanceGroup
in interface ManagedInstanceGroup
request
- The request object containing the details to sendpublic ManagedInstanceGroupWaiters getWaiters()
ManagedInstanceGroup
Gets the pre-configured waiters available for resources for this service.
getWaiters
in interface ManagedInstanceGroup
public ManagedInstanceGroupPaginators getPaginators()
ManagedInstanceGroup
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 ManagedInstanceGroup
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
Copyright © 2016–2023. All rights reserved.