SDK for PHP 3.x

Client: Aws\BedrockDataAutomationRuntime\BedrockDataAutomationRuntimeClient
Service ID: bedrock-data-automation-runtime
Version: 2024-06-13

This page describes the parameters and results for the operations of the Runtime for Amazon Bedrock Data Automation (2024-06-13), and shows how to use the Aws\BedrockDataAutomationRuntime\BedrockDataAutomationRuntimeClient object to call the described operations. This documentation is specific to the 2024-06-13 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

GetDataAutomationStatus ( array $params = [] )
API used to get data automation status.
InvokeDataAutomationAsync ( array $params = [] )
Async API: Invoke data automation.

Operations

GetDataAutomationStatus

$result = $client->getDataAutomationStatus([/* ... */]);
$promise = $client->getDataAutomationStatusAsync([/* ... */]);

API used to get data automation status.

Parameter Syntax

$result = $client->getDataAutomationStatus([
    'invocationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
invocationArn
Required: Yes
Type: string

Invocation arn.

Result Syntax

[
    'errorMessage' => '<string>',
    'errorType' => '<string>',
    'outputConfiguration' => [
        's3Uri' => '<string>',
    ],
    'status' => 'Created|InProgress|Success|ServiceError|ClientError',
]

Result Details

Members
errorMessage
Type: string

Error Message.

errorType
Type: string

Error Type.

outputConfiguration
Type: OutputConfiguration structure

Output configuration.

status
Type: string

Job Status.

Errors

AccessDeniedException:

This exception will be thrown when customer does not have access to API.

ValidationException:

This exception will be thrown when customer provided invalid parameters.

InternalServerException:

This exception is for any internal un-expected service errors.

ThrottlingException:

This exception will be thrown when customer reached API TPS limit.

ResourceNotFoundException:

This exception will be thrown when resource provided from customer not found.

InvokeDataAutomationAsync

$result = $client->invokeDataAutomationAsync([/* ... */]);
$promise = $client->invokeDataAutomationAsyncAsync([/* ... */]);

Async API: Invoke data automation.

Parameter Syntax

$result = $client->invokeDataAutomationAsync([
    'blueprints' => [
        [
            'blueprintArn' => '<string>', // REQUIRED
            'stage' => 'DEVELOPMENT|LIVE',
            'version' => '<string>',
        ],
        // ...
    ],
    'clientToken' => '<string>',
    'dataAutomationConfiguration' => [
        'dataAutomationArn' => '<string>', // REQUIRED
        'stage' => 'LIVE|DEVELOPMENT',
    ],
    'encryptionConfiguration' => [
        'kmsEncryptionContext' => ['<string>', ...],
        'kmsKeyId' => '<string>', // REQUIRED
    ],
    'inputConfiguration' => [ // REQUIRED
        's3Uri' => '<string>', // REQUIRED
    ],
    'notificationConfiguration' => [
        'eventBridgeConfiguration' => [ // REQUIRED
            'eventBridgeEnabled' => true || false, // REQUIRED
        ],
    ],
    'outputConfiguration' => [ // REQUIRED
        's3Uri' => '<string>', // REQUIRED
    ],
]);

Parameter Details

Members
blueprints
Type: Array of Blueprint structures

Blueprint list.

clientToken
Type: string

Idempotency token.

dataAutomationConfiguration
Type: DataAutomationConfiguration structure

Data automation configuration.

encryptionConfiguration
Type: EncryptionConfiguration structure

Encryption configuration.

inputConfiguration
Required: Yes
Type: InputConfiguration structure

Input configuration.

notificationConfiguration
Type: NotificationConfiguration structure

Notification configuration.

outputConfiguration
Required: Yes
Type: OutputConfiguration structure

Output configuration.

Result Syntax

[
    'invocationArn' => '<string>',
]

Result Details

Members
invocationArn
Required: Yes
Type: string

ARN of the automation job

Errors

ServiceQuotaExceededException:

This exception will be thrown when service quota is exceeded.

AccessDeniedException:

This exception will be thrown when customer does not have access to API.

ValidationException:

This exception will be thrown when customer provided invalid parameters.

InternalServerException:

This exception is for any internal un-expected service errors.

ThrottlingException:

This exception will be thrown when customer reached API TPS limit.

Shapes

AccessDeniedException

Description

This exception will be thrown when customer does not have access to API.

Members
message
Type: string

Blueprint

Description

Structure for single blueprint entity.

Members
blueprintArn
Required: Yes
Type: string

Arn of blueprint.

stage
Type: string

Stage of blueprint.

version
Type: string

Version of blueprint.

DataAutomationConfiguration

Description

Data automation configuration.

Members
dataAutomationArn
Required: Yes
Type: string

Data automation arn.

stage
Type: string

Data automation stage.

EncryptionConfiguration

Description

Encryption configuration.

Members
kmsEncryptionContext
Type: Associative array of custom strings keys (EncryptionContextKey) to strings

KMS encryption context.

kmsKeyId
Required: Yes
Type: string

KMS key id.

EventBridgeConfiguration

Description

Event bridge configuration.

Members
eventBridgeEnabled
Required: Yes
Type: boolean

Event bridge flag.

InputConfiguration

Description

Input configuration.

Members
s3Uri
Required: Yes
Type: string

S3 uri.

InternalServerException

Description

This exception is for any internal un-expected service errors.

Members
message
Type: string

NotificationConfiguration

Description

Notification configuration.

Members
eventBridgeConfiguration
Required: Yes
Type: EventBridgeConfiguration structure

Event bridge configuration.

OutputConfiguration

Description

Output configuration.

Members
s3Uri
Required: Yes
Type: string

S3 uri.

ResourceNotFoundException

Description

This exception will be thrown when resource provided from customer not found.

Members
message
Type: string

ServiceQuotaExceededException

Description

This exception will be thrown when service quota is exceeded.

Members
message
Type: string

ThrottlingException

Description

This exception will be thrown when customer reached API TPS limit.

Members
message
Type: string

ValidationException

Description

This exception will be thrown when customer provided invalid parameters.

Members
message
Type: string