Class Compliance

java.lang.Object
software.amazon.awssdk.services.securityhub.model.Compliance
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<Compliance.Builder,Compliance>
@Generated("software.amazon.awssdk:codegen") public final class Compliance extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Compliance.Builder,Compliance>

This object typically provides details about a control finding, such as applicable standards and the status of control checks. While finding providers can add custom content in Compliance object fields, they are typically used to review details of Security Hub control findings.

See Also:

  • Method Details

    • status

      public final ComplianceStatus status()

      Typically summarizes the result of a control check.

      For Security Hub controls, valid values for Status are as follows.

        • PASSED - Standards check passed for all evaluated resources.

        • WARNING - Some information is missing or this check is not supported for your configuration.

        • FAILED - Standards check failed for at least one evaluated resource.

        • NOT_AVAILABLE - Check could not be performed due to a service outage, API error, or because the result of the Config evaluation was NOT_APPLICABLE. If the Config evaluation result was NOT_APPLICABLE for a Security Hub control, Security Hub automatically archives the finding after 3 days.

      If the service returns an enum value that is not available in the current SDK version, status will return ComplianceStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from statusAsString().

      Returns:
      Typically summarizes the result of a control check.

      For Security Hub controls, valid values for Status are as follows.

        • PASSED - Standards check passed for all evaluated resources.

        • WARNING - Some information is missing or this check is not supported for your configuration.

        • FAILED - Standards check failed for at least one evaluated resource.

        • NOT_AVAILABLE - Check could not be performed due to a service outage, API error, or because the result of the Config evaluation was NOT_APPLICABLE. If the Config evaluation result was NOT_APPLICABLE for a Security Hub control, Security Hub automatically archives the finding after 3 days.

      See Also:

    • statusAsString

      public final String statusAsString()

      Typically summarizes the result of a control check.

      For Security Hub controls, valid values for Status are as follows.

        • PASSED - Standards check passed for all evaluated resources.

        • WARNING - Some information is missing or this check is not supported for your configuration.

        • FAILED - Standards check failed for at least one evaluated resource.

        • NOT_AVAILABLE - Check could not be performed due to a service outage, API error, or because the result of the Config evaluation was NOT_APPLICABLE. If the Config evaluation result was NOT_APPLICABLE for a Security Hub control, Security Hub automatically archives the finding after 3 days.

      If the service returns an enum value that is not available in the current SDK version, status will return ComplianceStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from statusAsString().

      Returns:
      Typically summarizes the result of a control check.

      For Security Hub controls, valid values for Status are as follows.

        • PASSED - Standards check passed for all evaluated resources.

        • WARNING - Some information is missing or this check is not supported for your configuration.

        • FAILED - Standards check failed for at least one evaluated resource.

        • NOT_AVAILABLE - Check could not be performed due to a service outage, API error, or because the result of the Config evaluation was NOT_APPLICABLE. If the Config evaluation result was NOT_APPLICABLE for a Security Hub control, Security Hub automatically archives the finding after 3 days.

      See Also:

    • hasRelatedRequirements

      public final boolean hasRelatedRequirements()
      For responses, this returns true if the service returned a value for the RelatedRequirements property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • relatedRequirements

      public final List<String> relatedRequirements()

      Typically provides the industry or regulatory framework requirements that are related to a control. The check for that control is aligned with these requirements.

      Array Members: Maximum number of 32 items.

      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 hasRelatedRequirements() method.

      Returns:
      Typically provides the industry or regulatory framework requirements that are related to a control. The check for that control is aligned with these requirements.

      Array Members: Maximum number of 32 items.

    • hasStatusReasons

      public final boolean hasStatusReasons()
      For responses, this returns true if the service returned a value for the StatusReasons property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • statusReasons

      public final List<StatusReason> statusReasons()

      Typically used to provide a list of reasons for the value of Status.

      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 hasStatusReasons() method.

      Returns:
      Typically used to provide a list of reasons for the value of Status.

    • securityControlId

      public final String securityControlId()

      Typically provides the unique identifier of a control across standards. For Security Hub controls, this field consists of an Amazon Web Services service and a unique number, such as APIGateway.5.

      Returns:
      Typically provides the unique identifier of a control across standards. For Security Hub controls, this field consists of an Amazon Web Services service and a unique number, such as APIGateway.5.

    • hasAssociatedStandards

      public final boolean hasAssociatedStandards()
      For responses, this returns true if the service returned a value for the AssociatedStandards property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • associatedStandards

      public final List<AssociatedStandard> associatedStandards()

      Typically provides an array of enabled security standards in which a security control is currently enabled.

      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 hasAssociatedStandards() method.

      Returns:
      Typically provides an array of enabled security standards in which a security control is currently enabled.

    • hasSecurityControlParameters

      public final boolean hasSecurityControlParameters()
      For responses, this returns true if the service returned a value for the SecurityControlParameters property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • securityControlParameters

      public final List<SecurityControlParameter> securityControlParameters()

      Typically an object that includes security control parameter names and values.

      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 hasSecurityControlParameters() method.

      Returns:
      Typically an object that includes security control parameter names and values.

    • toBuilder

      public Compliance.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<Compliance.Builder,Compliance>
      Returns:
      a builder for type T

    • builder

      public static Compliance.Builder builder()

    • serializableBuilderClass

      public static Class<? extends Compliance.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • 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.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.