imagebuilder / Client / get_component

get_component

imagebuilder.Client.get_component(**kwargs)

Gets a component object.

See also: AWS API Documentation

Request Syntax

response = client.get_component(
    componentBuildVersionArn='string'
)

Parameters:

componentBuildVersionArn (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the component that you want to get. Regex requires the suffix /\d+$.

Return type:

dict

Returns:

Response Syntax

{
    'requestId': 'string',
    'component': {
        'arn': 'string',
        'name': 'string',
        'version': 'string',
        'description': 'string',
        'changeDescription': 'string',
        'type': 'BUILD'|'TEST',
        'platform': 'Windows'|'Linux'|'macOS',
        'supportedOsVersions': [
            'string',
        ],
        'state': {
            'status': 'DEPRECATED'|'DISABLED'|'ACTIVE',
            'reason': 'string'
        },
        'parameters': [
            {
                'name': 'string',
                'type': 'string',
                'defaultValue': [
                    'string',
                ],
                'description': 'string'
            },
        ],
        'owner': 'string',
        'data': 'string',
        'kmsKeyId': 'string',
        'encrypted': True|False,
        'dateCreated': 'string',
        'tags': {
            'string': 'string'
        },
        'publisher': 'string',
        'obfuscate': True|False,
        'productCodes': [
            {
                'productCodeId': 'string',
                'productCodeType': 'marketplace'
            },
        ]
    }
}

Response Structure

• (dict) –

  • requestId (string) –

    The request ID that uniquely identifies this request.

  • component (dict) –

    The component object specified in the request.

    • arn (string) –

      The Amazon Resource Name (ARN) of the component.

    • name (string) –

      The name of the component.

    • version (string) –

      The version of the component.

    • description (string) –

      The description of the component.

    • changeDescription (string) –

      Describes what change has been made in this version of the component, or what makes this version different from other versions of the component.

    • type (string) –

      The component type specifies whether Image Builder uses the component to build the image or only to test it.

    • platform (string) –

      The operating system platform of the component.

    • supportedOsVersions (list) –

      The operating system (OS) version supported by the component. If the OS information is available, Image Builder performs a prefix match against the base image OS version during image recipe creation.

      • (string) –

    • state (dict) –

      Describes the current status of the component.

      • status (string) –

        The current state of the component.

      • reason (string) –

        Describes how or why the component changed state.

    • parameters (list) –

      Contains parameter details for each of the parameters that the component document defined for the component.

      • (dict) –

        Defines a parameter that is used to provide configuration details for the component.

        • name (string) –

          The name of this input parameter.

        • type (string) –

          The type of input this parameter provides. The currently supported value is “string”.

        • defaultValue (list) –

          The default value of this parameter if no input is provided.

          • (string) –

        • description (string) –

          Describes this parameter.

    • owner (string) –

      The owner of the component.

    • data (string) –

      Component data contains the YAML document content for the component.

    • kmsKeyId (string) –

      The KMS key identifier used to encrypt the component.

    • encrypted (boolean) –

      The encryption status of the component.

    • dateCreated (string) –

      The date that Image Builder created the component.

    • tags (dict) –

      The tags that apply to the component.

      • (string) –

        • (string) –

    • publisher (string) –

      Contains the name of the publisher if this is a third-party component. Otherwise, this property is empty.

    • obfuscate (boolean) –

      Indicates whether component source is hidden from view in the console, and from component detail results for API, CLI, or SDK operations.

    • productCodes (list) –

      Contains product codes that are used for billing purposes for Amazon Web Services Marketplace components.

      • (dict) –

        Information about a single product code.

        • productCodeId (string) –

          For Amazon Web Services Marketplace components, this contains the product code ID that can be stamped onto an EC2 AMI to ensure that components are billed correctly. If this property is empty, it might mean that the component is not published.

        • productCodeType (string) –

          The owner of the product code that’s billed. If this property is empty, it might mean that the component is not published.

Exceptions

• imagebuilder.Client.exceptions.ServiceException

• imagebuilder.Client.exceptions.ClientException

• imagebuilder.Client.exceptions.ServiceUnavailableException

• imagebuilder.Client.exceptions.InvalidRequestException

• imagebuilder.Client.exceptions.ForbiddenException

• imagebuilder.Client.exceptions.CallRateLimitExceededException