Class DockerVolumeConfiguration
- java.lang.Object
-
- software.amazon.awssdk.services.ecs.model.DockerVolumeConfiguration
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<DockerVolumeConfiguration.Builder,DockerVolumeConfiguration>
@Generated("software.amazon.awssdk:codegen") public final class DockerVolumeConfiguration extends Object implements SdkPojo, Serializable, ToCopyableBuilder<DockerVolumeConfiguration.Builder,DockerVolumeConfiguration>
This parameter is specified when you're using Docker volumes. Docker volumes are only supported when you're using the EC2 launch type. Windows containers only support the use of the
localdriver. To use bind mounts, specify ahostinstead.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceDockerVolumeConfiguration.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Booleanautoprovision()If this value istrue, the Docker volume is created if it doesn't already exist.static DockerVolumeConfiguration.Builderbuilder()Stringdriver()The Docker volume driver to use.Map<String,String>driverOpts()A map of Docker driver-specific options passed through.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasDriverOpts()For responses, this returns true if the service returned a value for the DriverOpts property.inthashCode()booleanhasLabels()For responses, this returns true if the service returned a value for the Labels property.Map<String,String>labels()Custom metadata to add to your Docker volume.Scopescope()The scope for the Docker volume that determines its lifecycle.StringscopeAsString()The scope for the Docker volume that determines its lifecycle.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends DockerVolumeConfiguration.Builder>serializableBuilderClass()DockerVolumeConfiguration.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
scope
public final Scope scope()
The scope for the Docker volume that determines its lifecycle. Docker volumes that are scoped to a
taskare automatically provisioned when the task starts and destroyed when the task stops. Docker volumes that are scoped assharedpersist after the task stops.If the service returns an enum value that is not available in the current SDK version,
scopewill returnScope.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromscopeAsString().- Returns:
- The scope for the Docker volume that determines its lifecycle. Docker volumes that are scoped to a
taskare automatically provisioned when the task starts and destroyed when the task stops. Docker volumes that are scoped assharedpersist after the task stops. - See Also:
Scope
-
scopeAsString
public final String scopeAsString()
The scope for the Docker volume that determines its lifecycle. Docker volumes that are scoped to a
taskare automatically provisioned when the task starts and destroyed when the task stops. Docker volumes that are scoped assharedpersist after the task stops.If the service returns an enum value that is not available in the current SDK version,
scopewill returnScope.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromscopeAsString().- Returns:
- The scope for the Docker volume that determines its lifecycle. Docker volumes that are scoped to a
taskare automatically provisioned when the task starts and destroyed when the task stops. Docker volumes that are scoped assharedpersist after the task stops. - See Also:
Scope
-
autoprovision
public final Boolean autoprovision()
If this value is
true, the Docker volume is created if it doesn't already exist.This field is only used if the
scopeisshared.- Returns:
- If this value is
true, the Docker volume is created if it doesn't already exist.This field is only used if the
scopeisshared.
-
driver
public final String driver()
The Docker volume driver to use. The driver value must match the driver name provided by Docker because it is used for task placement. If the driver was installed using the Docker plugin CLI, use
docker plugin lsto retrieve the driver name from your container instance. If the driver was installed using another method, use Docker plugin discovery to retrieve the driver name. This parameter maps toDriverin the docker container create command and thexxdriveroption to docker volume create.- Returns:
- The Docker volume driver to use. The driver value must match the driver name provided by Docker because
it is used for task placement. If the driver was installed using the Docker plugin CLI, use
docker plugin lsto retrieve the driver name from your container instance. If the driver was installed using another method, use Docker plugin discovery to retrieve the driver name. This parameter maps toDriverin the docker container create command and thexxdriveroption to docker volume create.
-
hasDriverOpts
public final boolean hasDriverOpts()
For responses, this returns true if the service returned a value for the DriverOpts property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
driverOpts
public final Map<String,String> driverOpts()
A map of Docker driver-specific options passed through. This parameter maps to
DriverOptsin the docker create-volume command and thexxoptoption to docker volume create.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasDriverOpts()method.- Returns:
- A map of Docker driver-specific options passed through. This parameter maps to
DriverOptsin the docker create-volume command and thexxoptoption to docker volume create.
-
hasLabels
public final boolean hasLabels()
For responses, this returns true if the service returned a value for the Labels property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
labels
public final Map<String,String> labels()
Custom metadata to add to your Docker volume. This parameter maps to
Labelsin the docker container create command and thexxlabeloption to docker volume create.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasLabels()method.- Returns:
- Custom metadata to add to your Docker volume. This parameter maps to
Labelsin the docker container create command and thexxlabeloption to docker volume create.
-
toBuilder
public DockerVolumeConfiguration.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<DockerVolumeConfiguration.Builder,DockerVolumeConfiguration>
-
builder
public static DockerVolumeConfiguration.Builder builder()
-
serializableBuilderClass
public static Class<? extends DockerVolumeConfiguration.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final 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.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-