FileCache (AWS SDK for Java

java.lang.Object
- com.amazonaws.services.fsx.model.FileCache

All Implemented Interfaces:

StructuredPojo, Serializable, Cloneable
```
@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class FileCache
extends Object
implements Serializable, Cloneable, StructuredPojo
```
A description of a specific Amazon File Cache resource, which is a response object from the DescribeFileCaches operation.

See Also:

AWS API Documentation, Serialized Form

Constructor Summary

Constructors
Constructor and Description

FileCache()

Constructors
Constructor and Description
`FileCache()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`FileCache`	`clone()`
`boolean`	`equals(Object obj)`
`Date`	`getCreationTime()`
`List<String>`	`getDataRepositoryAssociationIds()` A list of IDs of data repository associations that are associated with this cache.
`String`	`getDNSName()` The Domain Name System (DNS) name for the cache.
`FileCacheFailureDetails`	`getFailureDetails()` A structure providing details of any failures that occurred.
`String`	`getFileCacheId()` The system-generated, unique ID of the cache.
`String`	`getFileCacheType()` The type of cache, which must be `LUSTRE`.
`String`	`getFileCacheTypeVersion()` The Lustre version of the cache, which must be `2.12`.
`String`	`getKmsKeyId()` Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache.
`String`	`getLifecycle()` The lifecycle status of the cache.
`FileCacheLustreConfiguration`	`getLustreConfiguration()` The configuration for the Amazon File Cache resource.
`List<String>`	`getNetworkInterfaceIds()`
`String`	`getOwnerId()`
`String`	`getResourceARN()`
`Integer`	`getStorageCapacity()` The storage capacity of the cache in gibibytes (GiB).
`List<String>`	`getSubnetIds()`
`String`	`getVpcId()`
`int`	`hashCode()`
`void`	`marshall(ProtocolMarshaller protocolMarshaller)` Marshalls this structured data using the given `ProtocolMarshaller`.
`void`	`setCreationTime(Date creationTime)`
`void`	`setDataRepositoryAssociationIds(Collection<String> dataRepositoryAssociationIds)` A list of IDs of data repository associations that are associated with this cache.
`void`	`setDNSName(String dNSName)` The Domain Name System (DNS) name for the cache.
`void`	`setFailureDetails(FileCacheFailureDetails failureDetails)` A structure providing details of any failures that occurred.
`void`	`setFileCacheId(String fileCacheId)` The system-generated, unique ID of the cache.
`void`	`setFileCacheType(String fileCacheType)` The type of cache, which must be `LUSTRE`.
`void`	`setFileCacheTypeVersion(String fileCacheTypeVersion)` The Lustre version of the cache, which must be `2.12`.
`void`	`setKmsKeyId(String kmsKeyId)` Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache.
`void`	`setLifecycle(String lifecycle)` The lifecycle status of the cache.
`void`	`setLustreConfiguration(FileCacheLustreConfiguration lustreConfiguration)` The configuration for the Amazon File Cache resource.
`void`	`setNetworkInterfaceIds(Collection<String> networkInterfaceIds)`
`void`	`setOwnerId(String ownerId)`
`void`	`setResourceARN(String resourceARN)`
`void`	`setStorageCapacity(Integer storageCapacity)` The storage capacity of the cache in gibibytes (GiB).
`void`	`setSubnetIds(Collection<String> subnetIds)`
`void`	`setVpcId(String vpcId)`
`String`	`toString()` Returns a string representation of this object.
`FileCache`	`withCreationTime(Date creationTime)`
`FileCache`	`withDataRepositoryAssociationIds(Collection<String> dataRepositoryAssociationIds)` A list of IDs of data repository associations that are associated with this cache.
`FileCache`	`withDataRepositoryAssociationIds(String... dataRepositoryAssociationIds)` A list of IDs of data repository associations that are associated with this cache.
`FileCache`	`withDNSName(String dNSName)` The Domain Name System (DNS) name for the cache.
`FileCache`	`withFailureDetails(FileCacheFailureDetails failureDetails)` A structure providing details of any failures that occurred.
`FileCache`	`withFileCacheId(String fileCacheId)` The system-generated, unique ID of the cache.
`FileCache`	`withFileCacheType(FileCacheType fileCacheType)` The type of cache, which must be `LUSTRE`.
`FileCache`	`withFileCacheType(String fileCacheType)` The type of cache, which must be `LUSTRE`.
`FileCache`	`withFileCacheTypeVersion(String fileCacheTypeVersion)` The Lustre version of the cache, which must be `2.12`.
`FileCache`	`withKmsKeyId(String kmsKeyId)` Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache.
`FileCache`	`withLifecycle(FileCacheLifecycle lifecycle)` The lifecycle status of the cache.
`FileCache`	`withLifecycle(String lifecycle)` The lifecycle status of the cache.
`FileCache`	`withLustreConfiguration(FileCacheLustreConfiguration lustreConfiguration)` The configuration for the Amazon File Cache resource.
`FileCache`	`withNetworkInterfaceIds(Collection<String> networkInterfaceIds)`
`FileCache`	`withNetworkInterfaceIds(String... networkInterfaceIds)` NOTE: This method appends the values to the existing list (if any).
`FileCache`	`withOwnerId(String ownerId)`
`FileCache`	`withResourceARN(String resourceARN)`
`FileCache`	`withStorageCapacity(Integer storageCapacity)` The storage capacity of the cache in gibibytes (GiB).
`FileCache`	`withSubnetIds(Collection<String> subnetIds)`
`FileCache`	`withSubnetIds(String... subnetIds)` NOTE: This method appends the values to the existing list (if any).
`FileCache`	`withVpcId(String vpcId)`

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - FileCache
```
public FileCache()
```
- Method Detail
  - setOwnerId
```
public void setOwnerId(String ownerId)
```
    Parameters:
    
    ownerId -
  - getOwnerId
```
public String getOwnerId()
```
    Returns:
  - withOwnerId
```
public FileCache withOwnerId(String ownerId)
```
    Parameters:
    
    ownerId -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setCreationTime
```
public void setCreationTime(Date creationTime)
```
    Parameters:
    
    creationTime -
  - getCreationTime
```
public Date getCreationTime()
```
    Returns:
  - withCreationTime
```
public FileCache withCreationTime(Date creationTime)
```
    Parameters:
    
    creationTime -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setFileCacheId
```
public void setFileCacheId(String fileCacheId)
```
    The system-generated, unique ID of the cache.
    
    Parameters:
    
    fileCacheId - The system-generated, unique ID of the cache.
  - getFileCacheId
```
public String getFileCacheId()
```
    The system-generated, unique ID of the cache.
    
    Returns:
    
    The system-generated, unique ID of the cache.
  - withFileCacheId
```
public FileCache withFileCacheId(String fileCacheId)
```
    The system-generated, unique ID of the cache.
    
    Parameters:
    
    fileCacheId - The system-generated, unique ID of the cache.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setFileCacheType
```
public void setFileCacheType(String fileCacheType)
```
    The type of cache, which must be LUSTRE.
    
    Parameters:
    
    fileCacheType - The type of cache, which must be LUSTRE.
    
    See Also:
    
    FileCacheType
  - getFileCacheType
```
public String getFileCacheType()
```
    The type of cache, which must be LUSTRE.
    
    Returns:
    
    The type of cache, which must be LUSTRE.
    
    See Also:
    
    FileCacheType
  - withFileCacheType
```
public FileCache withFileCacheType(String fileCacheType)
```
    The type of cache, which must be LUSTRE.
    
    Parameters:
    
    fileCacheType - The type of cache, which must be LUSTRE.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
    
    See Also:
    
    FileCacheType
  - withFileCacheType
```
public FileCache withFileCacheType(FileCacheType fileCacheType)
```
    The type of cache, which must be LUSTRE.
    
    Parameters:
    
    fileCacheType - The type of cache, which must be LUSTRE.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
    
    See Also:
    
    FileCacheType
  - setFileCacheTypeVersion
```
public void setFileCacheTypeVersion(String fileCacheTypeVersion)
```
    The Lustre version of the cache, which must be 2.12.
    
    Parameters:
    
    fileCacheTypeVersion - The Lustre version of the cache, which must be 2.12.
  - getFileCacheTypeVersion
```
public String getFileCacheTypeVersion()
```
    The Lustre version of the cache, which must be 2.12.
    
    Returns:
    
    The Lustre version of the cache, which must be 2.12.
  - withFileCacheTypeVersion
```
public FileCache withFileCacheTypeVersion(String fileCacheTypeVersion)
```
    The Lustre version of the cache, which must be 2.12.
    
    Parameters:
    
    fileCacheTypeVersion - The Lustre version of the cache, which must be 2.12.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setLifecycle
```
public void setLifecycle(String lifecycle)
```
    The lifecycle status of the cache. The following are the possible values and what they mean:
    - AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    - CREATING - The new cache is being created.
    - DELETING - An existing cache is being deleted.
    - UPDATING - The cache is undergoing a customer-initiated update.
    - FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    Parameters:
    lifecycle - The lifecycle status of the cache. The following are the possible values and what they mean:
    
    AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    
    CREATING - The new cache is being created.
    
    DELETING - An existing cache is being deleted.
    
    UPDATING - The cache is undergoing a customer-initiated update.
    
    FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    See Also:
    
    FileCacheLifecycle
  - getLifecycle
```
public String getLifecycle()
```
    The lifecycle status of the cache. The following are the possible values and what they mean:
    - AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    - CREATING - The new cache is being created.
    - DELETING - An existing cache is being deleted.
    - UPDATING - The cache is undergoing a customer-initiated update.
    - FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    Returns:
    The lifecycle status of the cache. The following are the possible values and what they mean:
    
    AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    
    CREATING - The new cache is being created.
    
    DELETING - An existing cache is being deleted.
    
    UPDATING - The cache is undergoing a customer-initiated update.
    
    FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    See Also:
    
    FileCacheLifecycle
  - withLifecycle
```
public FileCache withLifecycle(String lifecycle)
```
    The lifecycle status of the cache. The following are the possible values and what they mean:
    - AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    - CREATING - The new cache is being created.
    - DELETING - An existing cache is being deleted.
    - UPDATING - The cache is undergoing a customer-initiated update.
    - FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    Parameters:
    lifecycle - The lifecycle status of the cache. The following are the possible values and what they mean:
    
    AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    
    CREATING - The new cache is being created.
    
    DELETING - An existing cache is being deleted.
    
    UPDATING - The cache is undergoing a customer-initiated update.
    
    FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
    
    See Also:
    
    FileCacheLifecycle
  - withLifecycle
```
public FileCache withLifecycle(FileCacheLifecycle lifecycle)
```
    The lifecycle status of the cache. The following are the possible values and what they mean:
    - AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    - CREATING - The new cache is being created.
    - DELETING - An existing cache is being deleted.
    - UPDATING - The cache is undergoing a customer-initiated update.
    - FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    Parameters:
    lifecycle - The lifecycle status of the cache. The following are the possible values and what they mean:
    
    AVAILABLE - The cache is in a healthy state, and is reachable and available for use.
    
    CREATING - The new cache is being created.
    
    DELETING - An existing cache is being deleted.
    
    UPDATING - The cache is undergoing a customer-initiated update.
    
    FAILED - An existing cache has experienced an unrecoverable failure. When creating a new cache, the cache was unable to be created.
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
    
    See Also:
    
    FileCacheLifecycle
  - setFailureDetails
```
public void setFailureDetails(FileCacheFailureDetails failureDetails)
```
    A structure providing details of any failures that occurred.
    
    Parameters:
    
    failureDetails - A structure providing details of any failures that occurred.
  - getFailureDetails
```
public FileCacheFailureDetails getFailureDetails()
```
    A structure providing details of any failures that occurred.
    
    Returns:
    
    A structure providing details of any failures that occurred.
  - withFailureDetails
```
public FileCache withFailureDetails(FileCacheFailureDetails failureDetails)
```
    A structure providing details of any failures that occurred.
    
    Parameters:
    
    failureDetails - A structure providing details of any failures that occurred.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setStorageCapacity
```
public void setStorageCapacity(Integer storageCapacity)
```
    The storage capacity of the cache in gibibytes (GiB).
    
    Parameters:
    
    storageCapacity - The storage capacity of the cache in gibibytes (GiB).
  - getStorageCapacity
```
public Integer getStorageCapacity()
```
    The storage capacity of the cache in gibibytes (GiB).
    
    Returns:
    
    The storage capacity of the cache in gibibytes (GiB).
  - withStorageCapacity
```
public FileCache withStorageCapacity(Integer storageCapacity)
```
    The storage capacity of the cache in gibibytes (GiB).
    
    Parameters:
    
    storageCapacity - The storage capacity of the cache in gibibytes (GiB).
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setVpcId
```
public void setVpcId(String vpcId)
```
    Parameters:
    
    vpcId -
  - getVpcId
```
public String getVpcId()
```
    Returns:
  - withVpcId
```
public FileCache withVpcId(String vpcId)
```
    Parameters:
    
    vpcId -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - getSubnetIds
```
public List<String> getSubnetIds()
```
    Returns:
  - setSubnetIds
```
public void setSubnetIds(Collection<String> subnetIds)
```
    Parameters:
    
    subnetIds -
  - withSubnetIds
```
public FileCache withSubnetIds(String... subnetIds)
```
    NOTE: This method appends the values to the existing list (if any). Use setSubnetIds(java.util.Collection) or withSubnetIds(java.util.Collection) if you want to override the existing values.
    
    Parameters:
    
    subnetIds -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - withSubnetIds
```
public FileCache withSubnetIds(Collection<String> subnetIds)
```
    Parameters:
    
    subnetIds -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - getNetworkInterfaceIds
```
public List<String> getNetworkInterfaceIds()
```
    Returns:
  - setNetworkInterfaceIds
```
public void setNetworkInterfaceIds(Collection<String> networkInterfaceIds)
```
    Parameters:
    
    networkInterfaceIds -
  - withNetworkInterfaceIds
```
public FileCache withNetworkInterfaceIds(String... networkInterfaceIds)
```
    NOTE: This method appends the values to the existing list (if any). Use setNetworkInterfaceIds(java.util.Collection) or withNetworkInterfaceIds(java.util.Collection) if you want to override the existing values.
    
    Parameters:
    
    networkInterfaceIds -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - withNetworkInterfaceIds
```
public FileCache withNetworkInterfaceIds(Collection<String> networkInterfaceIds)
```
    Parameters:
    
    networkInterfaceIds -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setDNSName
```
public void setDNSName(String dNSName)
```
    The Domain Name System (DNS) name for the cache.
    
    Parameters:
    
    dNSName - The Domain Name System (DNS) name for the cache.
  - getDNSName
```
public String getDNSName()
```
    The Domain Name System (DNS) name for the cache.
    
    Returns:
    
    The Domain Name System (DNS) name for the cache.
  - withDNSName
```
public FileCache withDNSName(String dNSName)
```
    The Domain Name System (DNS) name for the cache.
    
    Parameters:
    
    dNSName - The Domain Name System (DNS) name for the cache.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setKmsKeyId
```
public void setKmsKeyId(String kmsKeyId)
```
    Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache. If a KmsKeyId isn't specified, the Amazon FSx-managed KMS key for your account is used. For more information, see Encrypt in the Key Management Service API Reference.
    
    Parameters:
    
    kmsKeyId - Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache. If a KmsKeyId isn't specified, the Amazon FSx-managed KMS key for your account is used. For more information, see Encrypt in the Key Management Service API Reference.
  - getKmsKeyId
```
public String getKmsKeyId()
```
    Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache. If a KmsKeyId isn't specified, the Amazon FSx-managed KMS key for your account is used. For more information, see Encrypt in the Key Management Service API Reference.
    
    Returns:
    
    Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache. If a KmsKeyId isn't specified, the Amazon FSx-managed KMS key for your account is used. For more information, see Encrypt in the Key Management Service API Reference.
  - withKmsKeyId
```
public FileCache withKmsKeyId(String kmsKeyId)
```
    Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache. If a KmsKeyId isn't specified, the Amazon FSx-managed KMS key for your account is used. For more information, see Encrypt in the Key Management Service API Reference.
    
    Parameters:
    
    kmsKeyId - Specifies the ID of the Key Management Service (KMS) key to use for encrypting data on an Amazon File Cache. If a KmsKeyId isn't specified, the Amazon FSx-managed KMS key for your account is used. For more information, see Encrypt in the Key Management Service API Reference.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setResourceARN
```
public void setResourceARN(String resourceARN)
```
    Parameters:
    
    resourceARN -
  - getResourceARN
```
public String getResourceARN()
```
    Returns:
  - withResourceARN
```
public FileCache withResourceARN(String resourceARN)
```
    Parameters:
    
    resourceARN -
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setLustreConfiguration
```
public void setLustreConfiguration(FileCacheLustreConfiguration lustreConfiguration)
```
    The configuration for the Amazon File Cache resource.
    
    Parameters:
    
    lustreConfiguration - The configuration for the Amazon File Cache resource.
  - getLustreConfiguration
```
public FileCacheLustreConfiguration getLustreConfiguration()
```
    The configuration for the Amazon File Cache resource.
    
    Returns:
    
    The configuration for the Amazon File Cache resource.
  - withLustreConfiguration
```
public FileCache withLustreConfiguration(FileCacheLustreConfiguration lustreConfiguration)
```
    The configuration for the Amazon File Cache resource.
    
    Parameters:
    
    lustreConfiguration - The configuration for the Amazon File Cache resource.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - getDataRepositoryAssociationIds
```
public List<String> getDataRepositoryAssociationIds()
```
    A list of IDs of data repository associations that are associated with this cache.
    
    Returns:
    
    A list of IDs of data repository associations that are associated with this cache.
  - setDataRepositoryAssociationIds
```
public void setDataRepositoryAssociationIds(Collection<String> dataRepositoryAssociationIds)
```
    A list of IDs of data repository associations that are associated with this cache.
    
    Parameters:
    
    dataRepositoryAssociationIds - A list of IDs of data repository associations that are associated with this cache.
  - withDataRepositoryAssociationIds
```
public FileCache withDataRepositoryAssociationIds(String... dataRepositoryAssociationIds)
```
    A list of IDs of data repository associations that are associated with this cache.
    
    NOTE: This method appends the values to the existing list (if any). Use setDataRepositoryAssociationIds(java.util.Collection) or withDataRepositoryAssociationIds(java.util.Collection) if you want to override the existing values.
    
    Parameters:
    
    dataRepositoryAssociationIds - A list of IDs of data repository associations that are associated with this cache.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - withDataRepositoryAssociationIds
```
public FileCache withDataRepositoryAssociationIds(Collection<String> dataRepositoryAssociationIds)
```
    A list of IDs of data repository associations that are associated with this cache.
    
    Parameters:
    
    dataRepositoryAssociationIds - A list of IDs of data repository associations that are associated with this cache.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - toString
```
public String toString()
```
    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.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    A string representation of this object.
    
    See Also:
    
    Object.toString()
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - clone
```
public FileCache clone()
```
    Overrides:
    
    clone in class Object
  - marshall
```
public void marshall(ProtocolMarshaller protocolMarshaller)
```
    Description copied from interface: StructuredPojo
    
    Marshalls this structured data using the given ProtocolMarshaller.
    
    Specified by:
    
    marshall in interface StructuredPojo
    
    Parameters:
    
    protocolMarshaller - Implementation of ProtocolMarshaller used to marshall this object's data.

AWS SDK for Java 1.x API Reference - 1.12.780

Class FileCache

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FileCache

Method Detail

setOwnerId

getOwnerId

withOwnerId

setCreationTime

getCreationTime

withCreationTime

setFileCacheId

getFileCacheId

withFileCacheId

setFileCacheType

getFileCacheType

withFileCacheType

withFileCacheType

setFileCacheTypeVersion

getFileCacheTypeVersion

withFileCacheTypeVersion

setLifecycle

getLifecycle

withLifecycle

withLifecycle

setFailureDetails

getFailureDetails

withFailureDetails

setStorageCapacity

getStorageCapacity

withStorageCapacity

setVpcId

getVpcId

withVpcId

getSubnetIds

setSubnetIds

withSubnetIds

withSubnetIds

getNetworkInterfaceIds

setNetworkInterfaceIds

withNetworkInterfaceIds

withNetworkInterfaceIds

setDNSName

getDNSName

withDNSName

setKmsKeyId

getKmsKeyId

withKmsKeyId

setResourceARN

getResourceARN

withResourceARN

setLustreConfiguration

getLustreConfiguration

withLustreConfiguration

getDataRepositoryAssociationIds

setDataRepositoryAssociationIds

withDataRepositoryAssociationIds

withDataRepositoryAssociationIds

toString

equals

hashCode

clone

marshall