CopyPartRequest (cos-java-sdk 5.2.6 API)

java.lang.Object
- com.qcloud.cos.internal.CosServiceRequest
- - com.qcloud.cos.model.CopyPartRequest

所有已实现的接口:

ReadLimitInfo, Serializable, Cloneable
```
public class CopyPartRequest
extends CosServiceRequest
implements Serializable
```
另请参阅:
序列化表格

构造器概要

构造器
构造器和说明

CopyPartRequest()

构造器
构造器和说明
`CopyPartRequest()`

方法概要

方法
限定符和类型	方法和说明
`String`	`getDestinationBucketName()` Gets the destination bucket name which will contain the new, copied object.
`String`	`getDestinationKey()` Gets the destination bucket key under which the new, copied object will be stored.
`Long`	`getFirstByte()` Returns the optional start range to copy from the source object.
`Long`	`getLastByte()` Returns the optional zero-based byte offset to stop copying the source.
`List<String>`	`getMatchingETagConstraints()` Gets the optional list of ETag constraints that, when present, must include a match for the source object's current ETag in order for the copy object request to be executed.
`Date`	`getModifiedSinceConstraint()` Gets the optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
`List<String>`	`getNonmatchingETagConstraints()` Gets the optional list of ETag constraints that, when present, must not include a match for the source object's current ETag in order for the copy object request to be executed.
`int`	`getPartNumber()` Returns the part number describing this part's position relative to the other parts in the multipart upload.
`String`	`getSourceAppid()`
`String`	`getSourceBucketName()` Gets the name of the bucket containing the source object to be copied.
`Region`	`getSourceBucketRegion()`
`String`	`getSourceKey()` Gets the source bucket key under which the source object to be copied is stored.
`String`	`getSourceVersionId()` Gets the version ID specifying which version of the source object to copy.
`Date`	`getUnmodifiedSinceConstraint()` Gets the optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date.
`String`	`getUploadId()` Returns the ID of the existing, initiated multipart upload with which this new part will be associated.
`void`	`setDestinationBucketName(String destinationBucketName)` Sets the destination bucket name which will contain the new, copied object.
`void`	`setDestinationKey(String destinationKey)` Sets the destination bucket key under which the new, copied object will be stored.
`void`	`setFirstByte(Long firstByte)` Sets the optional zero-based byte offset to begin copying the source object.
`void`	`setLastByte(Long lastByte)` Sets the optional zero-based byte offset to stop copying the source.
`void`	`setMatchingETagConstraints(List<String> eTagList)` Sets the optional list of ETag constraints that, when present, must include a match for the source object's current ETag in order for the copy object request to be executed.
`void`	`setModifiedSinceConstraint(Date date)` Sets the optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
`void`	`setNonmatchingETagConstraints(List<String> eTagList)` Sets the optional list of ETag constraints that, when present, must not include a match for the source object's current ETag in order for the copy object request to be executed.
`void`	`setPartNumber(int partNumber)` Sets the part number describing this part's position relative to the other parts in the multipart upload.
`void`	`setSourceAppid(String sourceAppid)`
`void`	`setSourceBucketName(String sourceBucketName)` Sets the name of the bucket containing the source object to be copied.
`void`	`setSourceBucketRegion(Region sourceBucketRegion)`
`void`	`setSourceKey(String sourceKey)` Sets the source bucket key under which the source object to be copied is stored.
`void`	`setSourceVersionId(String sourceVersionId)` Sets the optional version ID specifying which version of the source object to copy.
`void`	`setUnmodifiedSinceConstraint(Date date)` Sets the optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date.
`void`	`setUploadId(String uploadId)` Sets the ID of the existing, initiated multipart upload with which this new part will be associated.
`CopyPartRequest`	`withDestinationBucketName(String destinationBucketName)` Sets the name of the destination bucket which will contain the new, copied object and returns this object, enabling additional method calls to be chained together.
`CopyPartRequest`	`withDestinationKey(String destinationKey)` Sets the destination bucket key under which the new, copied object will be stored and returns this object, enabling additional method calls can be chained together.
`CopyPartRequest`	`withFirstByte(Long firstByte)` Sets the optional zero-based byte offset to begin copying the source object.
`CopyPartRequest`	`withLastByte(Long lastByte)` Sets the optional zero-based byte offset to stop copying the source.
`CopyPartRequest`	`withMatchingETagConstraint(String eTag)` Adds a single ETag constraint to this request and returns this object, enabling additional method calls to be chained together.
`CopyPartRequest`	`withMatchingETagConstraints(List<String> eTagList)` Fluent API for `setMatchingETagConstraints(List)`.
`CopyPartRequest`	`withModifiedSinceConstraint(Date date)` Sets the optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
`CopyPartRequest`	`withNonmatchingETagConstraint(String eTag)` Adds a single ETag constraint to this request and returns this object, enabling additional method calls to be chained together.
`CopyPartRequest`	`withNonmatchingETagConstraints(List<String> eTagList)` Fluent API for `setNonmatchingETagConstraints(List)`.
`CopyPartRequest`	`withPartNumber(int partNumber)` Sets the part number describing this part's position relative to the other parts in the multipart upload.
`CopyPartRequest`	`withSourceAppid(String sourceAppid)`
`CopyPartRequest`	`withSourceBucketName(String sourceBucketName)` Sets the name of the bucket containing the source object to be copied.
`CopyPartRequest`	`withSourceBucketRegion(Region sourceBucketRegion)`
`CopyPartRequest`	`withSourceKey(String sourceKey)` Sets the source bucket key under which the source object to be copied is stored.
`CopyPartRequest`	`withSourceVersionId(String sourceVersionId)` Sets the optional version ID specifying which version of the source object to copy.
`CopyPartRequest`	`withUnmodifiedSinceConstraint(Date date)` Sets the optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date.
`CopyPartRequest`	`withUploadId(String uploadId)` Sets the ID of the existing, initiated multipart upload with which this new part will be associated.

从类继承的方法 com.qcloud.cos.internal.CosServiceRequest
copyBaseTo, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, withGeneralProgressListener

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - CopyPartRequest
```
public CopyPartRequest()
```
- 方法详细资料
  - getUploadId
```
public String getUploadId()
```
    Returns the ID of the existing, initiated multipart upload with which this new part will be associated.
    
    返回:
    the ID of the existing, initiated multipart upload with which this new part will be associated.
  - setUploadId
```
public void setUploadId(String uploadId)
```
    Sets the ID of the existing, initiated multipart upload with which this new part will be associated.
    
    参数:
    uploadId - the ID of the existing, initiated multipart upload with which this new part will be associated.
  - withUploadId
```
public CopyPartRequest withUploadId(String uploadId)
```
    Sets the ID of the existing, initiated multipart upload with which this new part will be associated.
    
    参数:
    uploadId - the ID of the existing, initiated multipart upload with which this new part will be associated.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getPartNumber
```
public int getPartNumber()
```
    Returns the part number describing this part's position relative to the other parts in the multipart upload. Part number must be between 1 and 10,000 (inclusive).
    
    返回:
    the part number describing this part's position relative to the other parts in the multipart upload. Part number must be between 1 and 10,000 (inclusive).
  - setPartNumber
```
public void setPartNumber(int partNumber)
```
    Sets the part number describing this part's position relative to the other parts in the multipart upload. Part number must be between 1 and 10,000 (inclusive).
    
    参数:
    partNumber - the part number describing this part's position relative to the other parts in the multipart upload. Part number must be between 1 and 10,000 (inclusive).
  - withPartNumber
```
public CopyPartRequest withPartNumber(int partNumber)
```
    Sets the part number describing this part's position relative to the other parts in the multipart upload. Part number must be between 1 and 10,000 (inclusive).
    
    参数:
    partNumber - the part number describing this part's position relative to the other parts in the multipart upload. Part number must be between 1 and 10,000 (inclusive).
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getSourceAppid
```
public String getSourceAppid()
```
  - setSourceAppid
```
public void setSourceAppid(String sourceAppid)
```
  - withSourceAppid
```
public CopyPartRequest withSourceAppid(String sourceAppid)
```
  - getSourceBucketRegion
```
public Region getSourceBucketRegion()
```
  - setSourceBucketRegion
```
public void setSourceBucketRegion(Region sourceBucketRegion)
```
  - withSourceBucketRegion
```
public CopyPartRequest withSourceBucketRegion(Region sourceBucketRegion)
```
  - getSourceBucketName
```
public String getSourceBucketName()
```
    Gets the name of the bucket containing the source object to be copied.
    
    返回:
    The name of the bucket containing the source object to be copied.
    另请参阅:
    setSourceBucketName(String sourceBucketName)
  - setSourceBucketName
```
public void setSourceBucketName(String sourceBucketName)
```
    Sets the name of the bucket containing the source object to be copied.
    
    参数:
    sourceBucketName - The name of the bucket containing the source object to be copied.
    另请参阅:
    getSourceBucketName()
  - withSourceBucketName
```
public CopyPartRequest withSourceBucketName(String sourceBucketName)
```
    Sets the name of the bucket containing the source object to be copied.
    
    参数:
    sourceBucketName - The name of the bucket containing the source object to be copied.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
    另请参阅:
    getSourceBucketName()
  - getSourceKey
```
public String getSourceKey()
```
    Gets the source bucket key under which the source object to be copied is stored.
    
    返回:
    The source bucket key under which the source object to be copied is stored.
    另请参阅:
    setSourceKey(String sourceKey)
  - setSourceKey
```
public void setSourceKey(String sourceKey)
```
    Sets the source bucket key under which the source object to be copied is stored.
    
    参数:
    sourceKey - The source bucket key under which the source object to be copied is stored.
    另请参阅:
    setSourceKey(String sourceKey)
  - withSourceKey
```
public CopyPartRequest withSourceKey(String sourceKey)
```
    Sets the source bucket key under which the source object to be copied is stored.
    
    参数:
    sourceKey - The source bucket key under which the source object to be copied is stored.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
    另请参阅:
    setSourceKey(String sourceKey)
  - getSourceVersionId
```
public String getSourceVersionId()
```
    Gets the version ID specifying which version of the source object to copy. If not specified, the most recent version of the source object will be copied.
    
    Objects created before enabling versioning or when versioning is suspended are given the default null version ID (see Constants#NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.
    
    For more information about enabling versioning for a bucket, see COS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .
    
    返回:
    The version ID specifying which version of the source object to copy.
    另请参阅:
    Constants#NULL_VERSION_ID, setSourceVersionId(String sourceVersionId)
  - setSourceVersionId
```
public void setSourceVersionId(String sourceVersionId)
```
    Sets the optional version ID specifying which version of the source object to copy. If not specified, the most recent version of the source object will be copied.
    
    Objects created before enabling versioning or when versioning is suspended are given the default null version ID (see Constants#NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.
    
    For more information about enabling versioning for a bucket, see COS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .
    
    参数:
    sourceVersionId - The optional version ID specifying which version of the source object to copy.
  - withSourceVersionId
```
public CopyPartRequest withSourceVersionId(String sourceVersionId)
```
    Sets the optional version ID specifying which version of the source object to copy. If not specified, the most recent version of the source object will be copied.
    
    Objects created before enabling versioning or when versioning is suspended are given the default null version ID (see Constants#NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.
    
    For more information about enabling versioning for a bucket, see COS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest) .
    
    参数:
    sourceVersionId - The optional version ID specifying which version of the source object to copy.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getDestinationBucketName
```
public String getDestinationBucketName()
```
    Gets the destination bucket name which will contain the new, copied object.
    
    返回:
    The name of the destination bucket which will contain the new, copied object.
    另请参阅:
    setDestinationBucketName(String destinationBucketName)
  - setDestinationBucketName
```
public void setDestinationBucketName(String destinationBucketName)
```
    Sets the destination bucket name which will contain the new, copied object.
    
    参数:
    destinationBucketName - The name of the destination bucket which will contain the new, copied object.
    另请参阅:
    getDestinationBucketName()
  - withDestinationBucketName
```
public CopyPartRequest withDestinationBucketName(String destinationBucketName)
```
    Sets the name of the destination bucket which will contain the new, copied object and returns this object, enabling additional method calls to be chained together.
    
    参数:
    destinationBucketName - The name of the destination bucket which will contain the new, copied object.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getDestinationKey
```
public String getDestinationKey()
```
    Gets the destination bucket key under which the new, copied object will be stored.
    
    返回:
    The destination bucket key under which the new, copied object will be stored.
    另请参阅:
    setDestinationKey(String destinationKey)
  - setDestinationKey
```
public void setDestinationKey(String destinationKey)
```
    Sets the destination bucket key under which the new, copied object will be stored.
    
    参数:
    destinationKey - The destination bucket key under which the new, copied object will be stored.
    另请参阅:
    getDestinationKey()
  - withDestinationKey
```
public CopyPartRequest withDestinationKey(String destinationKey)
```
    Sets the destination bucket key under which the new, copied object will be stored and returns this object, enabling additional method calls can be chained together.
    
    参数:
    destinationKey - The destination bucket key under which the new, copied object will be stored.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getFirstByte
```
public Long getFirstByte()
```
    Returns the optional start range to copy from the source object.
    
    返回:
    the optional start range to copy from the source object.
  - setFirstByte
```
public void setFirstByte(Long firstByte)
```
    Sets the optional zero-based byte offset to begin copying the source object.
    
    参数:
    firstByte - the optional zero-based byte offset to begin copying the source object.
  - withFirstByte
```
public CopyPartRequest withFirstByte(Long firstByte)
```
    Sets the optional zero-based byte offset to begin copying the source object.
    
    参数:
    firstByte - the optional zero-based byte offset to begin copying the source object.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getLastByte
```
public Long getLastByte()
```
    Returns the optional zero-based byte offset to stop copying the source.
    
    返回:
    the optional zero-based byte offset to stop copying the source.
  - setLastByte
```
public void setLastByte(Long lastByte)
```
    Sets the optional zero-based byte offset to stop copying the source.
  - withLastByte
```
public CopyPartRequest withLastByte(Long lastByte)
```
    Sets the optional zero-based byte offset to stop copying the source.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getMatchingETagConstraints
```
public List<String> getMatchingETagConstraints()
```
    Gets the optional list of ETag constraints that, when present, must include a match for the source object's current ETag in order for the copy object request to be executed. Only one ETag in the list needs to match for the request to be executed by COS.
    
    Matching ETag constraints may be used with the unmodified since constraint, but not with any other type of constraint.
    
    返回:
    The optional list of ETag constraints that when present must include a match for the source object's current ETag in order for this request to be executed.
  - setMatchingETagConstraints
```
public void setMatchingETagConstraints(List<String> eTagList)
```
    Sets the optional list of ETag constraints that, when present, must include a match for the source object's current ETag in order for the copy object request to be executed. If none of the specified ETags match the source object's current ETag, the copy object operation will be aborted. Only one ETag in the list needs to match for the request to be executed by COS.
    
    Matching ETag constraints may be used with the unmodified since constraint, but not with any other type of constraint.
    
    参数:
    eTagList - The optional list of ETag constraints that must include a match for the source object's current ETag in order for this request to be executed.
  - withMatchingETagConstraints
```
public CopyPartRequest withMatchingETagConstraints(List<String> eTagList)
```
    Fluent API for setMatchingETagConstraints(List).
  - withMatchingETagConstraint
```
public CopyPartRequest withMatchingETagConstraint(String eTag)
```
    Adds a single ETag constraint to this request and returns this object, enabling additional method calls to be chained together. Multiple ETag constraints can be added to a request, but one must match the source object's current ETag in order for the copy object request to be executed. If none of the ETag constraints added to this request match the source object's current ETag, the copy object operation will be aborted.
    
    Matching ETag constraints may be used with the unmodified since constraint, but not with any other type of constraint.
    
    参数:
    eTag - The matching ETag constraint to add to this request.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getNonmatchingETagConstraints
```
public List<String> getNonmatchingETagConstraints()
```
    Gets the optional list of ETag constraints that, when present, must not include a match for the source object's current ETag in order for the copy object request to be executed. If any entry in the non-matching ETag constraint list matches the source object's current ETag, this copy request will not be executed by COS.
    
    Non-matching ETag constraints may be used with the modified since constraint, but not with any other type of constraint.
    
    返回:
    The optional list of ETag constraints that when present must not include a match for the source object's current ETag in order for this request to be executed.
  - setNonmatchingETagConstraints
```
public void setNonmatchingETagConstraints(List<String> eTagList)
```
    Sets the optional list of ETag constraints that, when present, must not include a match for the source object's current ETag in order for the copy object request to be executed. If any entry in the non-matching ETag constraint list matches the source object's current ETag, this copy request will not be executed by COS.
    
    Non-matching ETag constraints may be used with the modified since constraint, but not with any other type of constraint.
    
    参数:
    eTagList - The list of ETag constraints that, when present, must not include a match for the source object's current ETag in order for this request to be executed.
  - withNonmatchingETagConstraints
```
public CopyPartRequest withNonmatchingETagConstraints(List<String> eTagList)
```
    Fluent API for setNonmatchingETagConstraints(List).
  - withNonmatchingETagConstraint
```
public CopyPartRequest withNonmatchingETagConstraint(String eTag)
```
    Adds a single ETag constraint to this request and returns this object, enabling additional method calls to be chained together. Multiple ETag constraints can be added to a request, but all ETag constraints must not match the source object's current ETag in order for the copy object request to be executed. If any entry in the non-matching ETag constraint list matches the source object's current ETag, this copy request will not be executed by COS.
    
    Non-matching ETag constraints may be used with the modified since constraint, but not with any other type of constraint.
    
    参数:
    eTag - The non-matching ETag constraint to add to this request.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getUnmodifiedSinceConstraint
```
public Date getUnmodifiedSinceConstraint()
```
    Gets the optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date.
    
    The unmodified since constraint may be used with matching ETag constraints, but not with any other type of constraint.
    
    返回:
    The optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date.
  - setUnmodifiedSinceConstraint
```
public void setUnmodifiedSinceConstraint(Date date)
```
    Sets the optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date.
    
    The unmodified constraint may be used with matching ETag constraints, but not with any other type of constraint.
    
    Note that COS will ignore any dates occurring in the future.
    
    参数:
    date - The unmodified constraint that restricts this request to executing only if the source object has not been modified after this date.
  - withUnmodifiedSinceConstraint
```
public CopyPartRequest withUnmodifiedSinceConstraint(Date date)
```
    Sets the optional unmodified constraint that restricts this request to executing only if the source object has not been modified after the specified date. Returns this object, enabling additional method calls to be chained together.
    
    The unmodified constraint may be used with matching ETag constraints, but not with any other type of constraint.
    
    Note that COS will ignore any dates occurring in the future.
    
    参数:
    date - The unmodified constraint that restricts this request to executing only if the source object has not been modified after this date.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.
  - getModifiedSinceConstraint
```
public Date getModifiedSinceConstraint()
```
    Gets the optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
    
    The modified constraint may be used with non-matching ETag constraints, but not with any other type of constraint.
    
    返回:
    The optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
  - setModifiedSinceConstraint
```
public void setModifiedSinceConstraint(Date date)
```
    Sets the optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
    
    The modified constraint may be used with non-matching ETag constraints, but not with any other type of constraint.
    
    Note that COS will ignore any dates occurring in the future.
    
    参数:
    date - The modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
  - withModifiedSinceConstraint
```
public CopyPartRequest withModifiedSinceConstraint(Date date)
```
    Sets the optional modified constraint that restricts this request to executing only if the source object has been modified after the specified date. Returns this object, enabling additional method calls to be chained together.
    
    The modified constraint may be used with non-matching ETag constraints, but not with any other type of constraint.
    
    Note that COS will ignore any dates occurring in the future.
    
    参数:
    date - The modified constraint that restricts this request to executing only if the source object has been modified after the specified date.
    
    返回:
    This CopyPartRequest, enabling additional method calls to be chained together.

类 CopyPartRequest

构造器概要

方法概要

从类继承的方法 com.qcloud.cos.internal.CosServiceRequest

从类继承的方法 java.lang.Object

构造器详细资料

CopyPartRequest

方法详细资料

getUploadId

setUploadId

withUploadId

getPartNumber

setPartNumber

withPartNumber

getSourceAppid

setSourceAppid

withSourceAppid

getSourceBucketRegion

setSourceBucketRegion

withSourceBucketRegion

getSourceBucketName

setSourceBucketName

withSourceBucketName

getSourceKey

setSourceKey

withSourceKey

getSourceVersionId

setSourceVersionId

withSourceVersionId

getDestinationBucketName

setDestinationBucketName

withDestinationBucketName

getDestinationKey

setDestinationKey

withDestinationKey

getFirstByte

setFirstByte

withFirstByte

getLastByte

setLastByte

withLastByte

getMatchingETagConstraints

setMatchingETagConstraints

withMatchingETagConstraints

withMatchingETagConstraint

getNonmatchingETagConstraints

setNonmatchingETagConstraints

withNonmatchingETagConstraints

withNonmatchingETagConstraint

getUnmodifiedSinceConstraint

setUnmodifiedSinceConstraint

withUnmodifiedSinceConstraint

getModifiedSinceConstraint

setModifiedSinceConstraint

withModifiedSinceConstraint