Class DetectLabelsRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.rekognition.model.RekognitionRequest
-
- software.amazon.awssdk.services.rekognition.model.DetectLabelsRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<DetectLabelsRequest.Builder,DetectLabelsRequest>
@Generated("software.amazon.awssdk:codegen") public final class DetectLabelsRequest extends RekognitionRequest implements ToCopyableBuilder<DetectLabelsRequest.Builder,DetectLabelsRequest>
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceDetectLabelsRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static DetectLabelsRequest.Builderbuilder()booleanequals(Object obj)booleanequalsBySdkFields(Object obj)List<DetectLabelsFeatureName>features()A list of the types of analysis to perform.List<String>featuresAsStrings()A list of the types of analysis to perform.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasFeatures()For responses, this returns true if the service returned a value for the Features property.inthashCode()Imageimage()The input image as base64-encoded bytes or an S3 object.IntegermaxLabels()Maximum number of labels you want the service to return in the response.FloatminConfidence()Specifies the minimum confidence level for the labels to return.List<SdkField<?>>sdkFields()static Class<? extends DetectLabelsRequest.Builder>serializableBuilderClass()DetectLabelsSettingssettings()A list of the filters to be applied to returned detected labels and image properties.DetectLabelsRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
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
-
image
public final Image image()
The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing image bytes is not supported. Images stored in an S3 Bucket do not need to be base64-encoded.
If you are using an AWS SDK to call Amazon Rekognition, you might not need to base64-encode image bytes passed using the
Bytesfield. For more information, see Images in the Amazon Rekognition developer guide.- Returns:
- The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon
Rekognition operations, passing image bytes is not supported. Images stored in an S3 Bucket do not need
to be base64-encoded.
If you are using an AWS SDK to call Amazon Rekognition, you might not need to base64-encode image bytes passed using the
Bytesfield. For more information, see Images in the Amazon Rekognition developer guide.
-
maxLabels
public final Integer maxLabels()
Maximum number of labels you want the service to return in the response. The service returns the specified number of highest confidence labels. Only valid when GENERAL_LABELS is specified as a feature type in the Feature input parameter.
- Returns:
- Maximum number of labels you want the service to return in the response. The service returns the specified number of highest confidence labels. Only valid when GENERAL_LABELS is specified as a feature type in the Feature input parameter.
-
minConfidence
public final Float minConfidence()
Specifies the minimum confidence level for the labels to return. Amazon Rekognition doesn't return any labels with confidence lower than this specified value.
If
MinConfidenceis not specified, the operation returns labels with a confidence values greater than or equal to 55 percent. Only valid when GENERAL_LABELS is specified as a feature type in the Feature input parameter.- Returns:
- Specifies the minimum confidence level for the labels to return. Amazon Rekognition doesn't return any
labels with confidence lower than this specified value.
If
MinConfidenceis not specified, the operation returns labels with a confidence values greater than or equal to 55 percent. Only valid when GENERAL_LABELS is specified as a feature type in the Feature input parameter.
-
features
public final List<DetectLabelsFeatureName> features()
A list of the types of analysis to perform. Specifying GENERAL_LABELS uses the label detection feature, while specifying IMAGE_PROPERTIES returns information regarding image color and quality. If no option is specified GENERAL_LABELS is used by default.
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
hasFeatures()method.- Returns:
- A list of the types of analysis to perform. Specifying GENERAL_LABELS uses the label detection feature, while specifying IMAGE_PROPERTIES returns information regarding image color and quality. If no option is specified GENERAL_LABELS is used by default.
-
hasFeatures
public final boolean hasFeatures()
For responses, this returns true if the service returned a value for the Features 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.
-
featuresAsStrings
public final List<String> featuresAsStrings()
A list of the types of analysis to perform. Specifying GENERAL_LABELS uses the label detection feature, while specifying IMAGE_PROPERTIES returns information regarding image color and quality. If no option is specified GENERAL_LABELS is used by default.
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
hasFeatures()method.- Returns:
- A list of the types of analysis to perform. Specifying GENERAL_LABELS uses the label detection feature, while specifying IMAGE_PROPERTIES returns information regarding image color and quality. If no option is specified GENERAL_LABELS is used by default.
-
settings
public final DetectLabelsSettings settings()
A list of the filters to be applied to returned detected labels and image properties. Specified filters can be inclusive, exclusive, or a combination of both. Filters can be used for individual labels or label categories. The exact label names or label categories must be supplied. For a full list of labels and label categories, see Detecting labels.
- Returns:
- A list of the filters to be applied to returned detected labels and image properties. Specified filters can be inclusive, exclusive, or a combination of both. Filters can be used for individual labels or label categories. The exact label names or label categories must be supplied. For a full list of labels and label categories, see Detecting labels.
-
toBuilder
public DetectLabelsRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<DetectLabelsRequest.Builder,DetectLabelsRequest>- Specified by:
toBuilderin classRekognitionRequest
-
builder
public static DetectLabelsRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends DetectLabelsRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsRequest
-
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.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkRequest
-
-