com.amazonaws.services.datasync.model.UpdateLocationObjectStorageRequest Maven / Gradle / Ivy
Show all versions of aws-java-sdk-datasync Show documentation
/*
* Copyright 2019-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.datasync.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.AmazonWebServiceRequest;
/**
*
* @see AWS API Documentation
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class UpdateLocationObjectStorageRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable {
/**
*
* Specifies the ARN of the object storage system location that you're updating.
*
*/
private String locationArn;
/**
*
* Specifies the port that your object storage server accepts inbound network traffic on (for example, port 443).
*
*/
private Integer serverPort;
/**
*
* Specifies the protocol that your object storage server uses to communicate.
*
*/
private String serverProtocol;
/**
*
* Specifies the object prefix for your object storage server. If this is a source location, DataSync only copies
* objects with this prefix. If this is a destination location, DataSync writes all objects with this prefix.
*
*/
private String subdirectory;
/**
*
* Specifies the access key (for example, a user name) if credentials are required to authenticate with the object
* storage server.
*
*/
private String accessKey;
/**
*
* Specifies the secret key (for example, a password) if credentials are required to authenticate with the object
* storage server.
*
*/
private String secretKey;
/**
*
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
*
*/
private java.util.List agentArns;
/**
*
* Specifies a certificate chain for DataSync to authenticate with your object storage system if the system uses a
* private or self-signed certificate authority (CA). You must specify a single .pem file with a full
* certificate chain (for example, file:///home/user/.ssh/object_storage_certificates.pem).
*
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes before base64
* encoding). The following example cat command creates an object_storage_certificates.pem
* file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
*
*/
private java.nio.ByteBuffer serverCertificate;
/**
*
* Specifies the ARN of the object storage system location that you're updating.
*
*
* @param locationArn
* Specifies the ARN of the object storage system location that you're updating.
*/
public void setLocationArn(String locationArn) {
this.locationArn = locationArn;
}
/**
*
* Specifies the ARN of the object storage system location that you're updating.
*
*
* @return Specifies the ARN of the object storage system location that you're updating.
*/
public String getLocationArn() {
return this.locationArn;
}
/**
*
* Specifies the ARN of the object storage system location that you're updating.
*
*
* @param locationArn
* Specifies the ARN of the object storage system location that you're updating.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withLocationArn(String locationArn) {
setLocationArn(locationArn);
return this;
}
/**
*
* Specifies the port that your object storage server accepts inbound network traffic on (for example, port 443).
*
*
* @param serverPort
* Specifies the port that your object storage server accepts inbound network traffic on (for example, port
* 443).
*/
public void setServerPort(Integer serverPort) {
this.serverPort = serverPort;
}
/**
*
* Specifies the port that your object storage server accepts inbound network traffic on (for example, port 443).
*
*
* @return Specifies the port that your object storage server accepts inbound network traffic on (for example, port
* 443).
*/
public Integer getServerPort() {
return this.serverPort;
}
/**
*
* Specifies the port that your object storage server accepts inbound network traffic on (for example, port 443).
*
*
* @param serverPort
* Specifies the port that your object storage server accepts inbound network traffic on (for example, port
* 443).
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withServerPort(Integer serverPort) {
setServerPort(serverPort);
return this;
}
/**
*
* Specifies the protocol that your object storage server uses to communicate.
*
*
* @param serverProtocol
* Specifies the protocol that your object storage server uses to communicate.
* @see ObjectStorageServerProtocol
*/
public void setServerProtocol(String serverProtocol) {
this.serverProtocol = serverProtocol;
}
/**
*
* Specifies the protocol that your object storage server uses to communicate.
*
*
* @return Specifies the protocol that your object storage server uses to communicate.
* @see ObjectStorageServerProtocol
*/
public String getServerProtocol() {
return this.serverProtocol;
}
/**
*
* Specifies the protocol that your object storage server uses to communicate.
*
*
* @param serverProtocol
* Specifies the protocol that your object storage server uses to communicate.
* @return Returns a reference to this object so that method calls can be chained together.
* @see ObjectStorageServerProtocol
*/
public UpdateLocationObjectStorageRequest withServerProtocol(String serverProtocol) {
setServerProtocol(serverProtocol);
return this;
}
/**
*
* Specifies the protocol that your object storage server uses to communicate.
*
*
* @param serverProtocol
* Specifies the protocol that your object storage server uses to communicate.
* @return Returns a reference to this object so that method calls can be chained together.
* @see ObjectStorageServerProtocol
*/
public UpdateLocationObjectStorageRequest withServerProtocol(ObjectStorageServerProtocol serverProtocol) {
this.serverProtocol = serverProtocol.toString();
return this;
}
/**
*
* Specifies the object prefix for your object storage server. If this is a source location, DataSync only copies
* objects with this prefix. If this is a destination location, DataSync writes all objects with this prefix.
*
*
* @param subdirectory
* Specifies the object prefix for your object storage server. If this is a source location, DataSync only
* copies objects with this prefix. If this is a destination location, DataSync writes all objects with this
* prefix.
*/
public void setSubdirectory(String subdirectory) {
this.subdirectory = subdirectory;
}
/**
*
* Specifies the object prefix for your object storage server. If this is a source location, DataSync only copies
* objects with this prefix. If this is a destination location, DataSync writes all objects with this prefix.
*
*
* @return Specifies the object prefix for your object storage server. If this is a source location, DataSync only
* copies objects with this prefix. If this is a destination location, DataSync writes all objects with this
* prefix.
*/
public String getSubdirectory() {
return this.subdirectory;
}
/**
*
* Specifies the object prefix for your object storage server. If this is a source location, DataSync only copies
* objects with this prefix. If this is a destination location, DataSync writes all objects with this prefix.
*
*
* @param subdirectory
* Specifies the object prefix for your object storage server. If this is a source location, DataSync only
* copies objects with this prefix. If this is a destination location, DataSync writes all objects with this
* prefix.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withSubdirectory(String subdirectory) {
setSubdirectory(subdirectory);
return this;
}
/**
*
* Specifies the access key (for example, a user name) if credentials are required to authenticate with the object
* storage server.
*
*
* @param accessKey
* Specifies the access key (for example, a user name) if credentials are required to authenticate with the
* object storage server.
*/
public void setAccessKey(String accessKey) {
this.accessKey = accessKey;
}
/**
*
* Specifies the access key (for example, a user name) if credentials are required to authenticate with the object
* storage server.
*
*
* @return Specifies the access key (for example, a user name) if credentials are required to authenticate with the
* object storage server.
*/
public String getAccessKey() {
return this.accessKey;
}
/**
*
* Specifies the access key (for example, a user name) if credentials are required to authenticate with the object
* storage server.
*
*
* @param accessKey
* Specifies the access key (for example, a user name) if credentials are required to authenticate with the
* object storage server.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withAccessKey(String accessKey) {
setAccessKey(accessKey);
return this;
}
/**
*
* Specifies the secret key (for example, a password) if credentials are required to authenticate with the object
* storage server.
*
*
* @param secretKey
* Specifies the secret key (for example, a password) if credentials are required to authenticate with the
* object storage server.
*/
public void setSecretKey(String secretKey) {
this.secretKey = secretKey;
}
/**
*
* Specifies the secret key (for example, a password) if credentials are required to authenticate with the object
* storage server.
*
*
* @return Specifies the secret key (for example, a password) if credentials are required to authenticate with the
* object storage server.
*/
public String getSecretKey() {
return this.secretKey;
}
/**
*
* Specifies the secret key (for example, a password) if credentials are required to authenticate with the object
* storage server.
*
*
* @param secretKey
* Specifies the secret key (for example, a password) if credentials are required to authenticate with the
* object storage server.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withSecretKey(String secretKey) {
setSecretKey(secretKey);
return this;
}
/**
*
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
*
*
* @return Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your
* location.
*/
public java.util.List getAgentArns() {
return agentArns;
}
/**
*
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
*
*
* @param agentArns
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your
* location.
*/
public void setAgentArns(java.util.Collection agentArns) {
if (agentArns == null) {
this.agentArns = null;
return;
}
this.agentArns = new java.util.ArrayList(agentArns);
}
/**
*
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setAgentArns(java.util.Collection)} or {@link #withAgentArns(java.util.Collection)} if you want to
* override the existing values.
*
*
* @param agentArns
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your
* location.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withAgentArns(String... agentArns) {
if (this.agentArns == null) {
setAgentArns(new java.util.ArrayList(agentArns.length));
}
for (String ele : agentArns) {
this.agentArns.add(ele);
}
return this;
}
/**
*
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
*
*
* @param agentArns
* Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your
* location.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withAgentArns(java.util.Collection agentArns) {
setAgentArns(agentArns);
return this;
}
/**
*
* Specifies a certificate chain for DataSync to authenticate with your object storage system if the system uses a
* private or self-signed certificate authority (CA). You must specify a single .pem file with a full
* certificate chain (for example, file:///home/user/.ssh/object_storage_certificates.pem).
*
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes before base64
* encoding). The following example cat command creates an object_storage_certificates.pem
* file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
*
*
* The AWS SDK for Java performs a Base64 encoding on this field before sending this request to the AWS service.
* Users of the SDK should not perform Base64 encoding on this field.
*
*
* Warning: ByteBuffers returned by the SDK are mutable. Changes to the content or position of the byte buffer will
* be seen by all objects that have a reference to this object. It is recommended to call ByteBuffer.duplicate() or
* ByteBuffer.asReadOnlyBuffer() before using or reading from the buffer. This behavior will be changed in a future
* major version of the SDK.
*
*
* @param serverCertificate
* Specifies a certificate chain for DataSync to authenticate with your object storage system if the system
* uses a private or self-signed certificate authority (CA). You must specify a single .pem file
* with a full certificate chain (for example,
* file:///home/user/.ssh/object_storage_certificates.pem).
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes before
* base64 encoding). The following example cat command creates an
* object_storage_certificates.pem file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
*/
public void setServerCertificate(java.nio.ByteBuffer serverCertificate) {
this.serverCertificate = serverCertificate;
}
/**
*
* Specifies a certificate chain for DataSync to authenticate with your object storage system if the system uses a
* private or self-signed certificate authority (CA). You must specify a single .pem file with a full
* certificate chain (for example, file:///home/user/.ssh/object_storage_certificates.pem).
*
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes before base64
* encoding). The following example cat command creates an object_storage_certificates.pem
* file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
*
*
* {@code ByteBuffer}s are stateful. Calling their {@code get} methods changes their {@code position}. We recommend
* using {@link java.nio.ByteBuffer#asReadOnlyBuffer()} to create a read-only view of the buffer with an independent
* {@code position}, and calling {@code get} methods on this rather than directly on the returned {@code ByteBuffer}.
* Doing so will ensure that anyone else using the {@code ByteBuffer} will not be affected by changes to the
* {@code position}.
*
*
* @return Specifies a certificate chain for DataSync to authenticate with your object storage system if the system
* uses a private or self-signed certificate authority (CA). You must specify a single .pem
* file with a full certificate chain (for example,
* file:///home/user/.ssh/object_storage_certificates.pem).
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes
* before base64 encoding). The following example cat command creates an
* object_storage_certificates.pem file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
*/
public java.nio.ByteBuffer getServerCertificate() {
return this.serverCertificate;
}
/**
*
* Specifies a certificate chain for DataSync to authenticate with your object storage system if the system uses a
* private or self-signed certificate authority (CA). You must specify a single .pem file with a full
* certificate chain (for example, file:///home/user/.ssh/object_storage_certificates.pem).
*
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes before base64
* encoding). The following example cat command creates an object_storage_certificates.pem
* file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
*
*
* The AWS SDK for Java performs a Base64 encoding on this field before sending this request to the AWS service.
* Users of the SDK should not perform Base64 encoding on this field.
*
*
* Warning: ByteBuffers returned by the SDK are mutable. Changes to the content or position of the byte buffer will
* be seen by all objects that have a reference to this object. It is recommended to call ByteBuffer.duplicate() or
* ByteBuffer.asReadOnlyBuffer() before using or reading from the buffer. This behavior will be changed in a future
* major version of the SDK.
*
*
* @param serverCertificate
* Specifies a certificate chain for DataSync to authenticate with your object storage system if the system
* uses a private or self-signed certificate authority (CA). You must specify a single .pem file
* with a full certificate chain (for example,
* file:///home/user/.ssh/object_storage_certificates.pem).
*
* The certificate chain might include:
*
*
* -
*
* The object storage system's certificate
*
*
* -
*
* All intermediate certificates (if there are any)
*
*
* -
*
* The root certificate of the signing CA
*
*
*
*
* You can concatenate your certificates into a .pem file (which can be up to 32768 bytes before
* base64 encoding). The following example cat command creates an
* object_storage_certificates.pem file that includes three certificates:
*
*
* cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem
*
*
* To use this parameter, configure ServerProtocol to HTTPS.
*
*
* Updating this parameter doesn't interfere with tasks that you have in progress.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateLocationObjectStorageRequest withServerCertificate(java.nio.ByteBuffer serverCertificate) {
setServerCertificate(serverCertificate);
return this;
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getLocationArn() != null)
sb.append("LocationArn: ").append(getLocationArn()).append(",");
if (getServerPort() != null)
sb.append("ServerPort: ").append(getServerPort()).append(",");
if (getServerProtocol() != null)
sb.append("ServerProtocol: ").append(getServerProtocol()).append(",");
if (getSubdirectory() != null)
sb.append("Subdirectory: ").append(getSubdirectory()).append(",");
if (getAccessKey() != null)
sb.append("AccessKey: ").append(getAccessKey()).append(",");
if (getSecretKey() != null)
sb.append("SecretKey: ").append("***Sensitive Data Redacted***").append(",");
if (getAgentArns() != null)
sb.append("AgentArns: ").append(getAgentArns()).append(",");
if (getServerCertificate() != null)
sb.append("ServerCertificate: ").append(getServerCertificate());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof UpdateLocationObjectStorageRequest == false)
return false;
UpdateLocationObjectStorageRequest other = (UpdateLocationObjectStorageRequest) obj;
if (other.getLocationArn() == null ^ this.getLocationArn() == null)
return false;
if (other.getLocationArn() != null && other.getLocationArn().equals(this.getLocationArn()) == false)
return false;
if (other.getServerPort() == null ^ this.getServerPort() == null)
return false;
if (other.getServerPort() != null && other.getServerPort().equals(this.getServerPort()) == false)
return false;
if (other.getServerProtocol() == null ^ this.getServerProtocol() == null)
return false;
if (other.getServerProtocol() != null && other.getServerProtocol().equals(this.getServerProtocol()) == false)
return false;
if (other.getSubdirectory() == null ^ this.getSubdirectory() == null)
return false;
if (other.getSubdirectory() != null && other.getSubdirectory().equals(this.getSubdirectory()) == false)
return false;
if (other.getAccessKey() == null ^ this.getAccessKey() == null)
return false;
if (other.getAccessKey() != null && other.getAccessKey().equals(this.getAccessKey()) == false)
return false;
if (other.getSecretKey() == null ^ this.getSecretKey() == null)
return false;
if (other.getSecretKey() != null && other.getSecretKey().equals(this.getSecretKey()) == false)
return false;
if (other.getAgentArns() == null ^ this.getAgentArns() == null)
return false;
if (other.getAgentArns() != null && other.getAgentArns().equals(this.getAgentArns()) == false)
return false;
if (other.getServerCertificate() == null ^ this.getServerCertificate() == null)
return false;
if (other.getServerCertificate() != null && other.getServerCertificate().equals(this.getServerCertificate()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getLocationArn() == null) ? 0 : getLocationArn().hashCode());
hashCode = prime * hashCode + ((getServerPort() == null) ? 0 : getServerPort().hashCode());
hashCode = prime * hashCode + ((getServerProtocol() == null) ? 0 : getServerProtocol().hashCode());
hashCode = prime * hashCode + ((getSubdirectory() == null) ? 0 : getSubdirectory().hashCode());
hashCode = prime * hashCode + ((getAccessKey() == null) ? 0 : getAccessKey().hashCode());
hashCode = prime * hashCode + ((getSecretKey() == null) ? 0 : getSecretKey().hashCode());
hashCode = prime * hashCode + ((getAgentArns() == null) ? 0 : getAgentArns().hashCode());
hashCode = prime * hashCode + ((getServerCertificate() == null) ? 0 : getServerCertificate().hashCode());
return hashCode;
}
@Override
public UpdateLocationObjectStorageRequest clone() {
return (UpdateLocationObjectStorageRequest) super.clone();
}
}