Runtime for Amazon Bedrock Data Automation 2024-06-13
- 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