Interface ResourceRequirement.Builder

All Superinterfaces:
Buildable, CopyableBuilder<ResourceRequirement.Builder,ResourceRequirement>, SdkBuilder<ResourceRequirement.Builder,ResourceRequirement>, SdkPojo
Enclosing class:
ResourceRequirement
@Mutable @NotThreadSafe public static interface ResourceRequirement.Builder extends SdkPojo, CopyableBuilder<ResourceRequirement.Builder,ResourceRequirement>

  • Method Details

    • value

      ResourceRequirement.Builder value(String value)

      The value for the specified resource type.

      You must specify this parameter unless the type is GPU and you specify sharingStrategy.

      When the type is GPU, the value is the number of physical GPUs the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on. You can also specify ALL to allocate all available GPUs on the instance to the container.

      When the type is NeuronDevice, the value must be ALL. This allocates all available Neuron devices on the instance to the container. Only one container in a task can specify NeuronDevice resources. This resource type is only supported on Managed Instances.

      When the type is InferenceAccelerator, the value matches the deviceName for an InferenceAccelerator specified in a task definition.

      Parameters:
      value - The value for the specified resource type.

      You must specify this parameter unless the type is GPU and you specify sharingStrategy.

      When the type is GPU, the value is the number of physical GPUs the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on. You can also specify ALL to allocate all available GPUs on the instance to the container.

      When the type is NeuronDevice, the value must be ALL. This allocates all available Neuron devices on the instance to the container. Only one container in a task can specify NeuronDevice resources. This resource type is only supported on Managed Instances.

      When the type is InferenceAccelerator, the value matches the deviceName for an InferenceAccelerator specified in a task definition.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • type

      ResourceRequirement.Builder type(String type)

      The type of resource to assign to a container.

      Parameters:
      type - The type of resource to assign to a container.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • type

      ResourceRequirement.Builder type(ResourceType type)

      The type of resource to assign to a container.

      Parameters:
      type - The type of resource to assign to a container.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • sharingStrategy

      ResourceRequirement.Builder sharingStrategy(SharingStrategy sharingStrategy)

      The strategy that the container uses to share a GPU with other containers. Specify a sharing strategy only when the type is GPU. For a GPU resource requirement, specify either value or sharingStrategy, but not both. If you don't specify a sharing strategy, the container has exclusive use of each GPU that Amazon ECS assigns to it. The containers in a task that request GPUs must all use the same option.

      You can use GPU sharing with tasks that run on Amazon EC2 instances or Amazon ECS Managed Instances. Task definitions that require EXTERNAL compatibility don't support GPU sharing.

      Parameters:
      sharingStrategy - The strategy that the container uses to share a GPU with other containers. Specify a sharing strategy only when the type is GPU. For a GPU resource requirement, specify either value or sharingStrategy, but not both. If you don't specify a sharing strategy, the container has exclusive use of each GPU that Amazon ECS assigns to it. The containers in a task that request GPUs must all use the same option.

      You can use GPU sharing with tasks that run on Amazon EC2 instances or Amazon ECS Managed Instances. Task definitions that require EXTERNAL compatibility don't support GPU sharing.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • sharingStrategy

      default ResourceRequirement.Builder sharingStrategy(Consumer<SharingStrategy.Builder> sharingStrategy)

      The strategy that the container uses to share a GPU with other containers. Specify a sharing strategy only when the type is GPU. For a GPU resource requirement, specify either value or sharingStrategy, but not both. If you don't specify a sharing strategy, the container has exclusive use of each GPU that Amazon ECS assigns to it. The containers in a task that request GPUs must all use the same option.

      You can use GPU sharing with tasks that run on Amazon EC2 instances or Amazon ECS Managed Instances. Task definitions that require EXTERNAL compatibility don't support GPU sharing.

      This is a convenience method that creates an instance of the SharingStrategy.Builder avoiding the need to create one manually via SharingStrategy.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to sharingStrategy(SharingStrategy).

      Parameters:
      sharingStrategy - a consumer that will call methods on SharingStrategy.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also: