AWS API Changes

2025/12/18 - Data Automation for Amazon Bedrock - 3 new4 updated api methods

Changes Blueprint Optimization (BPO) is a new Amazon Bedrock Data Automation (BDA) capability that improves blueprint inference accuracy using example content assets and ground truth data. BPO works by generating better instructions for fields in the Blueprint using provided data.

CopyBlueprintStage (new)

Link ¶

Copies a Blueprint from one stage to another

See also: AWS API Documentation

Request Syntax

client.copy_blueprint_stage(
    blueprintArn='string',
    sourceStage='DEVELOPMENT'|'LIVE',
    targetStage='DEVELOPMENT'|'LIVE',
    clientToken='string'
)

type blueprintArn:

string

param blueprintArn:

[REQUIRED]

Blueprint to be copied

type sourceStage:

string

param sourceStage:

[REQUIRED]

Source stage to copy from

type targetStage:

string

param targetStage:

[REQUIRED]

Target stage to copy to

type clientToken:

string

param clientToken:

Client token for idempotency

This field is autopopulated if not provided.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

(dict) --

CopyBlueprintStage Response

GetBlueprintOptimizationStatus (new)

Link ¶

API used to get blueprint optimization status.

See also: AWS API Documentation

Request Syntax

client.get_blueprint_optimization_status(
    invocationArn='string'
)

type invocationArn:

string

param invocationArn:

[REQUIRED]

Invocation arn.

rtype:

dict

returns:

Response Syntax

{
    'status': 'Created'|'InProgress'|'Success'|'ServiceError'|'ClientError',
    'errorType': 'string',
    'errorMessage': 'string',
    'outputConfiguration': {
        's3Object': {
            's3Uri': 'string',
            'version': 'string'
        }
    }
}

Response Structure

(dict) --

Response of GetBlueprintOptimizationStatus API.
- status (string) --
  
  Job Status.
- errorType (string) --
  
  Error Type.
- errorMessage (string) --
  
  Error Message.
- outputConfiguration (dict) --
  
  Output configuration.
  - s3Object (dict) --
    
    S3 object.
    - s3Uri (string) --
      
      S3 uri.
    - version (string) --
      
      S3 object version.

InvokeBlueprintOptimizationAsync (new)

Link ¶

Invoke an async job to perform Blueprint Optimization

See also: AWS API Documentation

Request Syntax

client.invoke_blueprint_optimization_async(
    blueprint={
        'blueprintArn': 'string',
        'stage': 'DEVELOPMENT'|'LIVE'
    },
    samples=[
        {
            'assetS3Object': {
                's3Uri': 'string',
                'version': 'string'
            },
            'groundTruthS3Object': {
                's3Uri': 'string',
                'version': 'string'
            }
        },
    ],
    outputConfiguration={
        's3Object': {
            's3Uri': 'string',
            'version': 'string'
        }
    },
    dataAutomationProfileArn='string',
    encryptionConfiguration={
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        }
    },
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ]
)

type blueprint:

dict

param blueprint:

[REQUIRED]

Blueprint to be optimized

blueprintArn (string) -- [REQUIRED]

Arn of blueprint.
stage (string) --

Stage of blueprint.

type samples:

list

param samples:

[REQUIRED]

List of Blueprint Optimization Samples

(dict) --

Blueprint Recommendation Sample
- assetS3Object (dict) -- [REQUIRED]
  
  S3 Object of the asset
  - s3Uri (string) -- [REQUIRED]
    
    S3 uri.
  - version (string) --
    
    S3 object version.
- groundTruthS3Object (dict) -- [REQUIRED]
  
  Ground truth for the Blueprint and Asset combination
  - s3Uri (string) -- [REQUIRED]
    
    S3 uri.
  - version (string) --
    
    S3 object version.

type outputConfiguration:

dict

param outputConfiguration:

[REQUIRED]

Output configuration where the results should be placed

s3Object (dict) -- [REQUIRED]

S3 object.
- s3Uri (string) -- [REQUIRED]
  
  S3 uri.
- version (string) --
  
  S3 object version.

type dataAutomationProfileArn:

string

param dataAutomationProfileArn:

[REQUIRED]

Data automation profile ARN

type encryptionConfiguration:

dict

param encryptionConfiguration:

Encryption configuration.

kmsKeyId (string) -- [REQUIRED]

KMS Key Identifier
kmsEncryptionContext (dict) --

KMS Encryption Context
- (string) --
  
  Encryption context key.
  - (string) --
    
    Encryption context value.

type tags:

list

param tags:

List of tags.

(dict) --

Key value pair of a tag
- key (string) -- [REQUIRED]
  
  Defines the context of the tag.
- value (string) -- [REQUIRED]
  
  Defines the value within the context. e.g. <key=reason, value=training>.

rtype:

dict

returns:

Response Syntax

{
    'invocationArn': 'string'
}

Response Structure

(dict) --

Invoke Blueprint Optimization Async Response
- invocationArn (string) --
  
  ARN of the blueprint optimization job

CreateBlueprint (updated)

Link ¶
Changes (response)

{'blueprint': {'optimizationSamples': [{'assetS3Object': {'s3Uri': 'string',
                                                          'version': 'string'},
                                        'groundTruthS3Object': {'s3Uri': 'string',
                                                                'version': 'string'}}],
               'optimizationTime': 'timestamp'}}

Creates an Amazon Bedrock Data Automation Blueprint

See also: AWS API Documentation

Request Syntax

client.create_blueprint(
    blueprintName='string',
    type='DOCUMENT'|'IMAGE'|'AUDIO'|'VIDEO',
    blueprintStage='DEVELOPMENT'|'LIVE',
    schema='string',
    clientToken='string',
    encryptionConfiguration={
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        }
    },
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ]
)

type blueprintName:

string

param blueprintName:

[REQUIRED]

Name of the Blueprint

type type:

string

param type:

[REQUIRED]

Type

type blueprintStage:

string

param blueprintStage:

Stage of the Blueprint

type schema:

string

param schema:

[REQUIRED]

Schema of the blueprint

type clientToken:

string

param clientToken:

Client specified token used for idempotency checks

This field is autopopulated if not provided.

type encryptionConfiguration:

dict

param encryptionConfiguration:

KMS Encryption Configuration

kmsKeyId (string) -- [REQUIRED]

KMS Key Identifier
kmsEncryptionContext (dict) --

KMS Encryption Context
- (string) --
  
  Encryption context key.
  - (string) --
    
    Encryption context value.

type tags:

list

param tags:

List of tags

(dict) --

Key value pair of a tag
- key (string) -- [REQUIRED]
  
  Defines the context of the tag.
- value (string) -- [REQUIRED]
  
  Defines the value within the context. e.g. <key=reason, value=training>.

rtype:

dict

returns:

Response Syntax

{
    'blueprint': {
        'blueprintArn': 'string',
        'schema': 'string',
        'type': 'DOCUMENT'|'IMAGE'|'AUDIO'|'VIDEO',
        'creationTime': datetime(2015, 1, 1),
        'lastModifiedTime': datetime(2015, 1, 1),
        'blueprintName': 'string',
        'blueprintVersion': 'string',
        'blueprintStage': 'DEVELOPMENT'|'LIVE',
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        },
        'optimizationSamples': [
            {
                'assetS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                },
                'groundTruthS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                }
            },
        ],
        'optimizationTime': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --

Create Blueprint Response
- blueprint (dict) --
  
  Contains the information of a Blueprint.
  - blueprintArn (string) --
    
    ARN of a Blueprint
  - schema (string) --
    
    Schema of the blueprint
  - type (string) --
    
    Type
  - creationTime (datetime) --
    
    Time Stamp
  - lastModifiedTime (datetime) --
    
    Time Stamp
  - blueprintName (string) --
    
    Name of the Blueprint
  - blueprintVersion (string) --
    
    Blueprint Version
  - blueprintStage (string) --
    
    Stage of the Blueprint
  - kmsKeyId (string) --
    
    KMS Key Identifier
  - kmsEncryptionContext (dict) --
    
    KMS Encryption Context
    - (string) --
      
      Encryption context key.
      - (string) --
        
        Encryption context value.
  - optimizationSamples (list) --
    
    List of Blueprint Optimization Samples
    - (dict) --
      
      Blueprint Recommendation Sample
      - assetS3Object (dict) --
        
        S3 Object of the asset
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
      - groundTruthS3Object (dict) --
        
        Ground truth for the Blueprint and Asset combination
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
  - optimizationTime (datetime) --
    
    Time Stamp

CreateBlueprintVersion (updated)

Link ¶
Changes (response)

{'blueprint': {'optimizationSamples': [{'assetS3Object': {'s3Uri': 'string',
                                                          'version': 'string'},
                                        'groundTruthS3Object': {'s3Uri': 'string',
                                                                'version': 'string'}}],
               'optimizationTime': 'timestamp'}}

Creates a new version of an existing Amazon Bedrock Data Automation Blueprint

See also: AWS API Documentation

Request Syntax

client.create_blueprint_version(
    blueprintArn='string',
    clientToken='string'
)

type blueprintArn:

string

param blueprintArn:

[REQUIRED]

ARN generated at the server side when a Blueprint is created

type clientToken:

string

param clientToken:

Client specified token used for idempotency checks

This field is autopopulated if not provided.

rtype:

dict

returns:

Response Syntax

{
    'blueprint': {
        'blueprintArn': 'string',
        'schema': 'string',
        'type': 'DOCUMENT'|'IMAGE'|'AUDIO'|'VIDEO',
        'creationTime': datetime(2015, 1, 1),
        'lastModifiedTime': datetime(2015, 1, 1),
        'blueprintName': 'string',
        'blueprintVersion': 'string',
        'blueprintStage': 'DEVELOPMENT'|'LIVE',
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        },
        'optimizationSamples': [
            {
                'assetS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                },
                'groundTruthS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                }
            },
        ],
        'optimizationTime': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --

Create Blueprint Version Response
- blueprint (dict) --
  
  Contains the information of a Blueprint.
  - blueprintArn (string) --
    
    ARN of a Blueprint
  - schema (string) --
    
    Schema of the blueprint
  - type (string) --
    
    Type
  - creationTime (datetime) --
    
    Time Stamp
  - lastModifiedTime (datetime) --
    
    Time Stamp
  - blueprintName (string) --
    
    Name of the Blueprint
  - blueprintVersion (string) --
    
    Blueprint Version
  - blueprintStage (string) --
    
    Stage of the Blueprint
  - kmsKeyId (string) --
    
    KMS Key Identifier
  - kmsEncryptionContext (dict) --
    
    KMS Encryption Context
    - (string) --
      
      Encryption context key.
      - (string) --
        
        Encryption context value.
  - optimizationSamples (list) --
    
    List of Blueprint Optimization Samples
    - (dict) --
      
      Blueprint Recommendation Sample
      - assetS3Object (dict) --
        
        S3 Object of the asset
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
      - groundTruthS3Object (dict) --
        
        Ground truth for the Blueprint and Asset combination
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
  - optimizationTime (datetime) --
    
    Time Stamp

GetBlueprint (updated)

Link ¶
Changes (response)

{'blueprint': {'optimizationSamples': [{'assetS3Object': {'s3Uri': 'string',
                                                          'version': 'string'},
                                        'groundTruthS3Object': {'s3Uri': 'string',
                                                                'version': 'string'}}],
               'optimizationTime': 'timestamp'}}

Gets an existing Amazon Bedrock Data Automation Blueprint

See also: AWS API Documentation

Request Syntax

client.get_blueprint(
    blueprintArn='string',
    blueprintVersion='string',
    blueprintStage='DEVELOPMENT'|'LIVE'
)

type blueprintArn:

string

param blueprintArn:

[REQUIRED]

ARN generated at the server side when a Blueprint is created

type blueprintVersion:

string

param blueprintVersion:

Optional field to get a specific Blueprint version

type blueprintStage:

string

param blueprintStage:

Optional field to get a specific Blueprint stage

rtype:

dict

returns:

Response Syntax

{
    'blueprint': {
        'blueprintArn': 'string',
        'schema': 'string',
        'type': 'DOCUMENT'|'IMAGE'|'AUDIO'|'VIDEO',
        'creationTime': datetime(2015, 1, 1),
        'lastModifiedTime': datetime(2015, 1, 1),
        'blueprintName': 'string',
        'blueprintVersion': 'string',
        'blueprintStage': 'DEVELOPMENT'|'LIVE',
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        },
        'optimizationSamples': [
            {
                'assetS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                },
                'groundTruthS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                }
            },
        ],
        'optimizationTime': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --

Get Blueprint Response
- blueprint (dict) --
  
  Contains the information of a Blueprint.
  - blueprintArn (string) --
    
    ARN of a Blueprint
  - schema (string) --
    
    Schema of the blueprint
  - type (string) --
    
    Type
  - creationTime (datetime) --
    
    Time Stamp
  - lastModifiedTime (datetime) --
    
    Time Stamp
  - blueprintName (string) --
    
    Name of the Blueprint
  - blueprintVersion (string) --
    
    Blueprint Version
  - blueprintStage (string) --
    
    Stage of the Blueprint
  - kmsKeyId (string) --
    
    KMS Key Identifier
  - kmsEncryptionContext (dict) --
    
    KMS Encryption Context
    - (string) --
      
      Encryption context key.
      - (string) --
        
        Encryption context value.
  - optimizationSamples (list) --
    
    List of Blueprint Optimization Samples
    - (dict) --
      
      Blueprint Recommendation Sample
      - assetS3Object (dict) --
        
        S3 Object of the asset
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
      - groundTruthS3Object (dict) --
        
        Ground truth for the Blueprint and Asset combination
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
  - optimizationTime (datetime) --
    
    Time Stamp

UpdateBlueprint (updated)

Link ¶
Changes (response)

{'blueprint': {'optimizationSamples': [{'assetS3Object': {'s3Uri': 'string',
                                                          'version': 'string'},
                                        'groundTruthS3Object': {'s3Uri': 'string',
                                                                'version': 'string'}}],
               'optimizationTime': 'timestamp'}}

Updates an existing Amazon Bedrock Data Automation Blueprint

See also: AWS API Documentation

Request Syntax

client.update_blueprint(
    blueprintArn='string',
    schema='string',
    blueprintStage='DEVELOPMENT'|'LIVE',
    encryptionConfiguration={
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        }
    }
)

type blueprintArn:

string

param blueprintArn:

[REQUIRED]

ARN generated at the server side when a Blueprint is created

type schema:

string

param schema:

[REQUIRED]

Schema of the blueprint

type blueprintStage:

string

param blueprintStage:

Stage of the Blueprint

type encryptionConfiguration:

dict

param encryptionConfiguration:

KMS Encryption Configuration

kmsKeyId (string) -- [REQUIRED]

KMS Key Identifier
kmsEncryptionContext (dict) --

KMS Encryption Context
- (string) --
  
  Encryption context key.
  - (string) --
    
    Encryption context value.

rtype:

dict

returns:

Response Syntax

{
    'blueprint': {
        'blueprintArn': 'string',
        'schema': 'string',
        'type': 'DOCUMENT'|'IMAGE'|'AUDIO'|'VIDEO',
        'creationTime': datetime(2015, 1, 1),
        'lastModifiedTime': datetime(2015, 1, 1),
        'blueprintName': 'string',
        'blueprintVersion': 'string',
        'blueprintStage': 'DEVELOPMENT'|'LIVE',
        'kmsKeyId': 'string',
        'kmsEncryptionContext': {
            'string': 'string'
        },
        'optimizationSamples': [
            {
                'assetS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                },
                'groundTruthS3Object': {
                    's3Uri': 'string',
                    'version': 'string'
                }
            },
        ],
        'optimizationTime': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --

Update Blueprint Response
- blueprint (dict) --
  
  Contains the information of a Blueprint.
  - blueprintArn (string) --
    
    ARN of a Blueprint
  - schema (string) --
    
    Schema of the blueprint
  - type (string) --
    
    Type
  - creationTime (datetime) --
    
    Time Stamp
  - lastModifiedTime (datetime) --
    
    Time Stamp
  - blueprintName (string) --
    
    Name of the Blueprint
  - blueprintVersion (string) --
    
    Blueprint Version
  - blueprintStage (string) --
    
    Stage of the Blueprint
  - kmsKeyId (string) --
    
    KMS Key Identifier
  - kmsEncryptionContext (dict) --
    
    KMS Encryption Context
    - (string) --
      
      Encryption context key.
      - (string) --
        
        Encryption context value.
  - optimizationSamples (list) --
    
    List of Blueprint Optimization Samples
    - (dict) --
      
      Blueprint Recommendation Sample
      - assetS3Object (dict) --
        
        S3 Object of the asset
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
      - groundTruthS3Object (dict) --
        
        Ground truth for the Blueprint and Asset combination
        
        s3Uri (string) --
        
        S3 uri.
        
        version (string) --
        
        S3 object version.
  - optimizationTime (datetime) --
    
    Time Stamp