# ComponentSummary
<a name="API_ComponentSummary"></a>

A high-level summary of a component.

## Contents
<a name="API_ComponentSummary_Contents"></a>

 ** arn **   <a name="imagebuilder-Type-ComponentSummary-arn"></a>
The Amazon Resource Name (ARN) of the component.  
Type: String  
Pattern: `^arn:aws[^:]*:imagebuilder:[^:]+:(?:[0-9]{12}|aws(?:-[a-z-]+)?):(?:image-recipe|container-recipe|infrastructure-configuration|distribution-configuration|component|image|image-pipeline|lifecycle-policy|workflow\/(?:build|test|distribution))/[a-z0-9-_]+(?:/(?:(?:x|[0-9]+)\.(?:x|[0-9]+)\.(?:x|[0-9]+))(?:/[0-9]+)?)?$`   
Required: No

 ** changeDescription **   <a name="imagebuilder-Type-ComponentSummary-changeDescription"></a>
The change description for the current version of the component.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** dateCreated **   <a name="imagebuilder-Type-ComponentSummary-dateCreated"></a>
The original creation date of the component.  
Type: String  
Required: No

 ** description **   <a name="imagebuilder-Type-ComponentSummary-description"></a>
The description of the component.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** name **   <a name="imagebuilder-Type-ComponentSummary-name"></a>
The name of the component.  
Type: String  
Pattern: `^[-_A-Za-z-0-9][-_A-Za-z0-9 ]{1,126}[-_A-Za-z-0-9]$`   
Required: No

 ** obfuscate **   <a name="imagebuilder-Type-ComponentSummary-obfuscate"></a>
Indicates whether component source is hidden from view in the console, and from component detail results for API, CLI, or SDK operations.  
Type: Boolean  
Required: No

 ** owner **   <a name="imagebuilder-Type-ComponentSummary-owner"></a>
The owner of the component.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** platform **   <a name="imagebuilder-Type-ComponentSummary-platform"></a>
The operating system platform of the component.  
Type: String  
Valid Values: `Windows | Linux | macOS`   
Required: No

 ** publisher **   <a name="imagebuilder-Type-ComponentSummary-publisher"></a>
Contains the name of the publisher if this is a third-party component. Otherwise, this property is empty.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** state **   <a name="imagebuilder-Type-ComponentSummary-state"></a>
Describes the current status of the component.  
Type: [ComponentState](API_ComponentState.md) object  
Required: No

 ** supportedOsVersions **   <a name="imagebuilder-Type-ComponentSummary-supportedOsVersions"></a>
The operating system (OS) version that the component supports. If the OS information is available, Image Builder performs a prefix match against the base image OS version during image recipe creation.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Length Constraints: Minimum length of 1.  
Required: No

 ** tags **   <a name="imagebuilder-Type-ComponentSummary-tags"></a>
The tags that apply to the component.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `^(?!aws:)[a-zA-Z0-9\s_.:/=+\-@]*$`   
Value Length Constraints: Maximum length of 256.  
Required: No

 ** type **   <a name="imagebuilder-Type-ComponentSummary-type"></a>
The component type specifies whether Image Builder uses the component to build the image or only to test it.  
Type: String  
Valid Values: `BUILD | TEST`   
Required: No

 ** version **   <a name="imagebuilder-Type-ComponentSummary-version"></a>
The version of the component.  
Type: String  
Pattern: `^[0-9]+\.[0-9]+\.[0-9]+$`   
Required: No

## See Also
<a name="API_ComponentSummary_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/imagebuilder-2019-12-02/ComponentSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/imagebuilder-2019-12-02/ComponentSummary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/imagebuilder-2019-12-02/ComponentSummary)