@Generated(value="OracleSDKGenerator", comments="API Version: 20160918") public class ObjectStorageClient extends Object implements ObjectStorage
Modifier and Type | Class and Description |
---|---|
static class |
ObjectStorageClient.Builder
Builder class for this client.
|
Modifier and Type | Field and Description |
---|---|
static Service |
SERVICE
Service instance for ObjectStorage.
|
Constructor and Description |
---|
ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Creates a new service instance using the given authentication provider and client configuration.
|
ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Creates a new service instance using the given authentication provider and client configuration.
|
ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Creates a new service instance using the given authentication provider and client configuration.
|
ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Creates a new service instance using the given authentication provider and client configuration.
|
ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint,
ExecutorService executorService)
Creates a new service instance using the given authentication provider and client configuration.
|
ObjectStorageClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Creates a new service instance using the given authentication provider.
|
ObjectStorageClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Creates a new service instance using the given authentication provider and client configuration.
|
ObjectStorageClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Creates a new service instance using the given authentication provider and client configuration.
|
Modifier and Type | Method and Description |
---|---|
AbortMultipartUploadResponse |
abortMultipartUpload(AbortMultipartUploadRequest request)
Aborts an in-progress multipart upload and deletes all parts that have been uploaded.
|
static ObjectStorageClient.Builder |
builder()
Create a builder for this client.
|
CancelWorkRequestResponse |
cancelWorkRequest(CancelWorkRequestRequest request)
Cancels a work request.
|
void |
close() |
CommitMultipartUploadResponse |
commitMultipartUpload(CommitMultipartUploadRequest request)
Commits a multipart upload, which involves checking part numbers and entity tags (ETags) of the parts, to create an aggregate object.
|
CopyObjectResponse |
copyObject(CopyObjectRequest request)
Creates a request to copy an object within a region or to another region.
|
CreateBucketResponse |
createBucket(CreateBucketRequest request)
Creates a bucket in the given namespace with a bucket name and optional user-defined metadata.
|
CreateMultipartUploadResponse |
createMultipartUpload(CreateMultipartUploadRequest request)
Starts a new multipart upload to a specific object in the given bucket in the given namespace.
|
CreatePreauthenticatedRequestResponse |
createPreauthenticatedRequest(CreatePreauthenticatedRequestRequest request)
Creates a pre-authenticated request specific to the bucket.
|
DeleteBucketResponse |
deleteBucket(DeleteBucketRequest request)
Deletes a bucket if the bucket is already empty.
|
DeleteObjectResponse |
deleteObject(DeleteObjectRequest request)
Deletes an object.
|
DeleteObjectLifecyclePolicyResponse |
deleteObjectLifecyclePolicy(DeleteObjectLifecyclePolicyRequest request)
Deletes the object lifecycle policy for the bucket.
|
DeletePreauthenticatedRequestResponse |
deletePreauthenticatedRequest(DeletePreauthenticatedRequestRequest request)
Deletes the pre-authenticated request for the bucket.
|
GetBucketResponse |
getBucket(GetBucketRequest request)
Gets the current representation of the given bucket in the given Object Storage namespace.
|
GetNamespaceResponse |
getNamespace(GetNamespaceRequest request)
Each Oracle Cloud Infrastructure tenant is assigned one unique and uneditable Object Storage namespace.
|
GetNamespaceMetadataResponse |
getNamespaceMetadata(GetNamespaceMetadataRequest request)
Gets the metadata for the Object Storage namespace, which contains defaultS3CompartmentId and defaultSwiftCompartmentId.
|
GetObjectResponse |
getObject(GetObjectRequest request)
Gets the metadata and body of an object.
|
GetObjectLifecyclePolicyResponse |
getObjectLifecyclePolicy(GetObjectLifecyclePolicyRequest request)
Gets the object lifecycle policy for the bucket.
|
ObjectStoragePaginators |
getPaginators()
Gets the pre-configured paginators available for list operations in this service which may return multiple pages of data.
|
GetPreauthenticatedRequestResponse |
getPreauthenticatedRequest(GetPreauthenticatedRequestRequest request)
Gets the pre-authenticated request for the bucket.
|
ObjectStorageWaiters |
getWaiters()
Gets the pre-configured waiters available for resources for this service.
|
GetWorkRequestResponse |
getWorkRequest(GetWorkRequestRequest request)
Gets the status of the work request for the given ID.
|
HeadBucketResponse |
headBucket(HeadBucketRequest request)
Efficiently checks to see if a bucket exists and gets the current entity tag (ETag) for the bucket.
|
HeadObjectResponse |
headObject(HeadObjectRequest request)
Gets the user-defined metadata and entity tag (ETag) for an object.
|
ListBucketsResponse |
listBuckets(ListBucketsRequest request)
Gets a list of all BucketSummary items in a compartment.
|
ListMultipartUploadPartsResponse |
listMultipartUploadParts(ListMultipartUploadPartsRequest request)
Lists the parts of an in-progress multipart upload.
|
ListMultipartUploadsResponse |
listMultipartUploads(ListMultipartUploadsRequest request)
Lists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace.
|
ListObjectsResponse |
listObjects(ListObjectsRequest request)
Lists the objects in a bucket.
|
ListPreauthenticatedRequestsResponse |
listPreauthenticatedRequests(ListPreauthenticatedRequestsRequest request)
Lists pre-authenticated requests for the bucket.
|
ListWorkRequestErrorsResponse |
listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Lists the errors of the work request with the given ID.
|
ListWorkRequestLogsResponse |
listWorkRequestLogs(ListWorkRequestLogsRequest request)
Lists the logs of the work request with the given ID.
|
ListWorkRequestsResponse |
listWorkRequests(ListWorkRequestsRequest request)
Lists the work requests in a compartment.
|
PutObjectResponse |
putObject(PutObjectRequest request)
Creates a new object or overwrites an existing one.
|
PutObjectLifecyclePolicyResponse |
putObjectLifecyclePolicy(PutObjectLifecyclePolicyRequest request)
Creates or replaces the object lifecycle policy for the bucket.
|
ReencryptBucketResponse |
reencryptBucket(ReencryptBucketRequest request)
Re-encrypts the unique data encryption key that encrypts each object written to the bucket by using the most recent version of the master encryption key assigned to the bucket.
|
RenameObjectResponse |
renameObject(RenameObjectRequest request)
Rename an object in the given Object Storage namespace.
|
RestoreObjectsResponse |
restoreObjects(RestoreObjectsRequest request)
Restores one or more objects specified by the objectName parameter.
|
void |
setEndpoint(String endpoint)
Sets the endpoint to call (ex, https://www.example.com).
|
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’).
|
UpdateBucketResponse |
updateBucket(UpdateBucketRequest request)
Performs a partial or full update of a bucket’s user-defined metadata.
|
UpdateNamespaceMetadataResponse |
updateNamespaceMetadata(UpdateNamespaceMetadataRequest request)
By default, buckets created using the Amazon S3 Compatibility API or the Swift API are created in the root compartment of the Oracle Cloud Infrastructure tenancy.
|
UploadPartResponse |
uploadPart(UploadPartRequest request)
Uploads a single part of a multipart upload.
|
public static final Service SERVICE
Service instance for ObjectStorage.
public ObjectStorageClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Creates a new service instance using the given authentication provider.
authenticationDetailsProvider
- The authentication details provider, required.public ObjectStorageClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Creates a new service instance using the given authentication provider and client configuration.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.public ObjectStorageClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.public ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.public ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.additionalClientConfigurators
- Additional client configurators to be run after the primary configurator.public ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.additionalClientConfigurators
- Additional client configurators to be run after the primary configurator.endpoint
- Endpoint, or null to leave unset (note, may be overridden by authenticationDetailsProvider
)public ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.signingStrategyRequestSignerFactories
- The request signer factories for each signing strategy used to create the request signeradditionalClientConfigurators
- Additional client configurators to be run after the primary configurator.endpoint
- Endpoint, or null to leave unset (note, may be overridden by authenticationDetailsProvider
)public ObjectStorageClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.signingStrategyRequestSignerFactories
- The request signer factories for each signing strategy used to create the request signeradditionalClientConfigurators
- Additional client configurators to be run after the primary configurator.endpoint
- Endpoint, or null to leave unset (note, may be overridden by authenticationDetailsProvider
)executorService
- ExecutorService used by the client, or null to use the default configured ThreadPoolExecutorpublic static ObjectStorageClient.Builder builder()
Create a builder for this client.
public void setEndpoint(String endpoint)
ObjectStorage
Sets the endpoint to call (ex, https://www.example.com).
setEndpoint
in interface ObjectStorage
endpoint
- The endpoint of the service.public void setRegion(Region region)
ObjectStorage
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 ObjectStorage
region
- The region of the service.public void setRegion(String regionId)
ObjectStorage
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 ObjectStorage
regionId
- The public region ID.public void close()
close
in interface AutoCloseable
public AbortMultipartUploadResponse abortMultipartUpload(AbortMultipartUploadRequest request)
ObjectStorage
Aborts an in-progress multipart upload and deletes all parts that have been uploaded.
abortMultipartUpload
in interface ObjectStorage
request
- The request object containing the details to sendpublic CancelWorkRequestResponse cancelWorkRequest(CancelWorkRequestRequest request)
ObjectStorage
Cancels a work request.
cancelWorkRequest
in interface ObjectStorage
request
- The request object containing the details to sendpublic CommitMultipartUploadResponse commitMultipartUpload(CommitMultipartUploadRequest request)
ObjectStorage
Commits a multipart upload, which involves checking part numbers and entity tags (ETags) of the parts, to create an aggregate object.
commitMultipartUpload
in interface ObjectStorage
request
- The request object containing the details to sendpublic CopyObjectResponse copyObject(CopyObjectRequest request)
ObjectStorage
Creates a request to copy an object within a region or to another region.
copyObject
in interface ObjectStorage
request
- The request object containing the details to sendpublic CreateBucketResponse createBucket(CreateBucketRequest request)
ObjectStorage
Creates a bucket in the given namespace with a bucket name and optional user-defined metadata. Avoid entering confidential information in bucket names.
createBucket
in interface ObjectStorage
request
- The request object containing the details to sendpublic CreateMultipartUploadResponse createMultipartUpload(CreateMultipartUploadRequest request)
ObjectStorage
Starts a new multipart upload to a specific object in the given bucket in the given namespace.
createMultipartUpload
in interface ObjectStorage
request
- The request object containing the details to sendpublic CreatePreauthenticatedRequestResponse createPreauthenticatedRequest(CreatePreauthenticatedRequestRequest request)
ObjectStorage
Creates a pre-authenticated request specific to the bucket.
createPreauthenticatedRequest
in interface ObjectStorage
request
- The request object containing the details to sendpublic DeleteBucketResponse deleteBucket(DeleteBucketRequest request)
ObjectStorage
Deletes a bucket if the bucket is already empty. If the bucket is not empty, use deleteObject
first. In addition, you cannot delete a bucket that has a multipart upload in progress or a pre-authenticated request associated with that bucket.
deleteBucket
in interface ObjectStorage
request
- The request object containing the details to sendpublic DeleteObjectResponse deleteObject(DeleteObjectRequest request)
ObjectStorage
Deletes an object.
deleteObject
in interface ObjectStorage
request
- The request object containing the details to sendpublic DeleteObjectLifecyclePolicyResponse deleteObjectLifecyclePolicy(DeleteObjectLifecyclePolicyRequest request)
ObjectStorage
Deletes the object lifecycle policy for the bucket.
deleteObjectLifecyclePolicy
in interface ObjectStorage
request
- The request object containing the details to sendpublic DeletePreauthenticatedRequestResponse deletePreauthenticatedRequest(DeletePreauthenticatedRequestRequest request)
ObjectStorage
Deletes the pre-authenticated request for the bucket.
deletePreauthenticatedRequest
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetBucketResponse getBucket(GetBucketRequest request)
ObjectStorage
Gets the current representation of the given bucket in the given Object Storage namespace.
getBucket
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetNamespaceResponse getNamespace(GetNamespaceRequest request)
ObjectStorage
Each Oracle Cloud Infrastructure tenant is assigned one unique and uneditable Object Storage namespace. The namespace is a system-generated string assigned during account creation. For some older tenancies, the namespace string may be the tenancy name in all lower-case letters. You cannot edit a namespace.
GetNamespace returns the name of the Object Storage namespace for the user making the request. If an optional compartmentId query parameter is provided, GetNamespace returns the namespace name of the corresponding tenancy, provided the user has access to it.
getNamespace
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetNamespaceMetadataResponse getNamespaceMetadata(GetNamespaceMetadataRequest request)
ObjectStorage
Gets the metadata for the Object Storage namespace, which contains defaultS3CompartmentId and defaultSwiftCompartmentId.
Any user with the OBJECTSTORAGE_NAMESPACE_READ permission will be able to see the current metadata. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.
getNamespaceMetadata
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetObjectResponse getObject(GetObjectRequest request)
ObjectStorage
Gets the metadata and body of an object.
getObject
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetObjectLifecyclePolicyResponse getObjectLifecyclePolicy(GetObjectLifecyclePolicyRequest request)
ObjectStorage
Gets the object lifecycle policy for the bucket.
getObjectLifecyclePolicy
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetPreauthenticatedRequestResponse getPreauthenticatedRequest(GetPreauthenticatedRequestRequest request)
ObjectStorage
Gets the pre-authenticated request for the bucket.
getPreauthenticatedRequest
in interface ObjectStorage
request
- The request object containing the details to sendpublic GetWorkRequestResponse getWorkRequest(GetWorkRequestRequest request)
ObjectStorage
Gets the status of the work request for the given ID.
getWorkRequest
in interface ObjectStorage
request
- The request object containing the details to sendpublic HeadBucketResponse headBucket(HeadBucketRequest request)
ObjectStorage
Efficiently checks to see if a bucket exists and gets the current entity tag (ETag) for the bucket.
headBucket
in interface ObjectStorage
request
- The request object containing the details to sendpublic HeadObjectResponse headObject(HeadObjectRequest request)
ObjectStorage
Gets the user-defined metadata and entity tag (ETag) for an object.
headObject
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListBucketsResponse listBuckets(ListBucketsRequest request)
ObjectStorage
Gets a list of all BucketSummary items in a compartment. A BucketSummary contains only summary fields for the bucket and does not contain fields like the user-defined metadata.
To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.
listBuckets
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListMultipartUploadPartsResponse listMultipartUploadParts(ListMultipartUploadPartsRequest request)
ObjectStorage
Lists the parts of an in-progress multipart upload.
listMultipartUploadParts
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest request)
ObjectStorage
Lists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace.
listMultipartUploads
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListObjectsResponse listObjects(ListObjectsRequest request)
ObjectStorage
Lists the objects in a bucket.
To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.
listObjects
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListPreauthenticatedRequestsResponse listPreauthenticatedRequests(ListPreauthenticatedRequestsRequest request)
ObjectStorage
Lists pre-authenticated requests for the bucket.
listPreauthenticatedRequests
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListWorkRequestErrorsResponse listWorkRequestErrors(ListWorkRequestErrorsRequest request)
ObjectStorage
Lists the errors of the work request with the given ID.
listWorkRequestErrors
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListWorkRequestLogsResponse listWorkRequestLogs(ListWorkRequestLogsRequest request)
ObjectStorage
Lists the logs of the work request with the given ID.
listWorkRequestLogs
in interface ObjectStorage
request
- The request object containing the details to sendpublic ListWorkRequestsResponse listWorkRequests(ListWorkRequestsRequest request)
ObjectStorage
Lists the work requests in a compartment.
listWorkRequests
in interface ObjectStorage
request
- The request object containing the details to sendpublic PutObjectResponse putObject(PutObjectRequest request)
ObjectStorage
Creates a new object or overwrites an existing one. See Special Instructions for Object Storage PUT for request signature requirements.
putObject
in interface ObjectStorage
request
- The request object containing the details to sendpublic PutObjectLifecyclePolicyResponse putObjectLifecyclePolicy(PutObjectLifecyclePolicyRequest request)
ObjectStorage
Creates or replaces the object lifecycle policy for the bucket.
putObjectLifecyclePolicy
in interface ObjectStorage
request
- The request object containing the details to sendpublic ReencryptBucketResponse reencryptBucket(ReencryptBucketRequest request)
ObjectStorage
Re-encrypts the unique data encryption key that encrypts each object written to the bucket by using the most recent version of the master encryption key assigned to the bucket. (All data encryption keys are encrypted by a master encryption key. Master encryption keys are assigned to buckets and managed by Oracle by default, but you can assign a key that you created and control through the Oracle Cloud Infrastructure Key Management service.) The kmsKeyId property of the bucket determines which master encryption key is assigned to the bucket. If you assigned a different Key Management master encryption key to the bucket, you can call this API to re-encrypt all data encryption keys with the newly assigned key. Similarly, you might want to re-encrypt all data encryption keys if the assigned key has been rotated to a new key version since objects were last added to the bucket. If you call this API and there is no kmsKeyId associated with the bucket, the call will fail.
Calling this API starts a work request task to re-encrypt the data encryption key of all objects in the bucket. Only objects created before the time of the API call will be re-encrypted. The call can take a long time, depending on how many objects are in the bucket and how big they are. This API returns a work request ID that you can use to retrieve the status of the work request task.
reencryptBucket
in interface ObjectStorage
request
- The request object containing the details to sendpublic RenameObjectResponse renameObject(RenameObjectRequest request)
ObjectStorage
Rename an object in the given Object Storage namespace.
renameObject
in interface ObjectStorage
request
- The request object containing the details to sendpublic RestoreObjectsResponse restoreObjects(RestoreObjectsRequest request)
ObjectStorage
Restores one or more objects specified by the objectName parameter. By default objects will be restored for 24 hours. Duration can be configured using the hours parameter.
restoreObjects
in interface ObjectStorage
request
- The request object containing the details to sendpublic UpdateBucketResponse updateBucket(UpdateBucketRequest request)
ObjectStorage
Performs a partial or full update of a bucket’s user-defined metadata.
Use UpdateBucket to move a bucket from one compartment to another within the same tenancy. Supply the compartmentID of the compartment that you want to move the bucket to. For more information about moving resources between compartments, see Moving Resources to a Different Compartment.
updateBucket
in interface ObjectStorage
request
- The request object containing the details to sendpublic UpdateNamespaceMetadataResponse updateNamespaceMetadata(UpdateNamespaceMetadataRequest request)
ObjectStorage
By default, buckets created using the Amazon S3 Compatibility API or the Swift API are created in the root compartment of the Oracle Cloud Infrastructure tenancy.
You can change the default Swift/Amazon S3 compartmentId designation to a different compartmentId. All subsequent bucket creations will use the new default compartment, but no previously created buckets will be modified. A user must have OBJECTSTORAGE_NAMESPACE_UPDATE permission to make changes to the default compartments for Amazon S3 and Swift.
updateNamespaceMetadata
in interface ObjectStorage
request
- The request object containing the details to sendpublic UploadPartResponse uploadPart(UploadPartRequest request)
ObjectStorage
Uploads a single part of a multipart upload.
uploadPart
in interface ObjectStorage
request
- The request object containing the details to sendpublic ObjectStorageWaiters getWaiters()
ObjectStorage
Gets the pre-configured waiters available for resources for this service.
getWaiters
in interface ObjectStorage
public ObjectStoragePaginators getPaginators()
ObjectStorage
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 ObjectStorage
Copyright © 2016–2020. All rights reserved.