Bedrock¶
Client¶
AsyncBedrockClient
¶
AsyncBedrockClient(config: AsyncBedrockConfig | None = None, plugins: list[Plugin] | None = None)
Describes the API operations for creating, managing, fine-turning, and evaluating Amazon Bedrock models.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
config
|
AsyncBedrockConfig | None
|
Optional configuration for the client. Here you can set things like the endpoint for HTTP services or auth credentials. |
None
|
plugins
|
list[Plugin] | None
|
A list of callables applied once to the client's base configuration. Their changes are inherited by every operation invocation. |
None
|
Operations¶
batch_delete_advanced_prompt_optimization_jobbatch_delete_evaluation_jobcancel_automated_reasoning_policy_build_workflowcreate_advanced_prompt_optimization_jobcreate_automated_reasoning_policycreate_automated_reasoning_policy_test_casecreate_automated_reasoning_policy_versioncreate_custom_modelcreate_custom_model_deploymentcreate_evaluation_jobcreate_foundation_model_agreementcreate_guardrailcreate_guardrail_versioncreate_inference_profilecreate_marketplace_model_endpointcreate_model_copy_jobcreate_model_customization_jobcreate_model_import_jobcreate_model_invocation_jobcreate_prompt_routercreate_provisioned_model_throughputdelete_automated_reasoning_policydelete_automated_reasoning_policy_build_workflowdelete_automated_reasoning_policy_test_casedelete_custom_modeldelete_custom_model_deploymentdelete_enforced_guardrail_configurationdelete_foundation_model_agreementdelete_guardraildelete_imported_modeldelete_inference_profiledelete_marketplace_model_endpointdelete_model_invocation_logging_configurationdelete_prompt_routerdelete_provisioned_model_throughputdelete_resource_policyderegister_marketplace_model_endpointexport_automated_reasoning_policy_versionget_account_data_retentionget_advanced_prompt_optimization_jobget_automated_reasoning_policyget_automated_reasoning_policy_annotationsget_automated_reasoning_policy_build_workflowget_automated_reasoning_policy_build_workflow_result_assetsget_automated_reasoning_policy_next_scenarioget_automated_reasoning_policy_test_caseget_automated_reasoning_policy_test_resultget_custom_modelget_custom_model_deploymentget_evaluation_jobget_foundation_modelget_foundation_model_availabilityget_guardrailget_imported_modelget_inference_profileget_marketplace_model_endpointget_model_copy_jobget_model_customization_jobget_model_import_jobget_model_invocation_jobget_model_invocation_logging_configurationget_prompt_routerget_provisioned_model_throughputget_resource_policyget_use_case_for_model_accesslist_advanced_prompt_optimization_jobslist_automated_reasoning_policieslist_automated_reasoning_policy_build_workflowslist_automated_reasoning_policy_test_caseslist_automated_reasoning_policy_test_resultslist_custom_model_deploymentslist_custom_modelslist_enforced_guardrails_configurationlist_evaluation_jobslist_foundation_model_agreement_offerslist_foundation_modelslist_guardrailslist_imported_modelslist_inference_profileslist_marketplace_model_endpointslist_model_copy_jobslist_model_customization_jobslist_model_import_jobslist_model_invocation_jobslist_prompt_routerslist_provisioned_model_throughputslist_tags_for_resourceput_account_data_retentionput_enforced_guardrail_configurationput_model_invocation_logging_configurationput_resource_policyput_use_case_for_model_accessregister_marketplace_model_endpointstart_automated_reasoning_policy_build_workflowstart_automated_reasoning_policy_test_workflowstop_advanced_prompt_optimization_jobstop_evaluation_jobstop_model_customization_jobstop_model_invocation_jobtag_resourceuntag_resourceupdate_automated_reasoning_policyupdate_automated_reasoning_policy_annotationsupdate_automated_reasoning_policy_test_caseupdate_custom_model_deploymentupdate_guardrailupdate_marketplace_model_endpointupdate_provisioned_model_throughput
Configuration¶
AsyncBedrockConfig
dataclass
¶
Bases: AsyncAwsConfig
Bedrock configuration (async-resolved).
Attributes¶
auth_scheme_resolver
class-attribute
instance-attribute
¶
An auth scheme resolver that determines the auth scheme for each operation.
auth_schemes
class-attribute
instance-attribute
¶
A map of auth scheme ids to auth schemes.
aws_access_key_id
class-attribute
instance-attribute
¶
aws_access_key_id: str | None = None
The identifier for a secret access key.
aws_credentials_identity_resolver
class-attribute
instance-attribute
¶
aws_credentials_identity_resolver: IdentityResolver[AWSCredentialsIdentity, AWSIdentityProperties] | None = None
Resolves AWS Credentials. Required for operations that use Sigv4 Auth.
aws_secret_access_key
class-attribute
instance-attribute
¶
aws_secret_access_key: str | None = None
A secret access key that can be used to sign requests.
aws_session_token
class-attribute
instance-attribute
¶
aws_session_token: str | None = None
The session token used with temporary AWS credentials.
endpoint_resolver
class-attribute
instance-attribute
¶
The endpoint resolver used to resolve the final endpoint per-operation based on the configuration.
interceptors
class-attribute
instance-attribute
¶
The list of interceptors, which are hooks that are called during the execution of a request.
protocol
class-attribute
instance-attribute
¶
The protocol to serialize and deserialize requests with.
region
class-attribute
instance-attribute
¶
region: str | None = None
The AWS region to connect to. The configured region is used to determine the service endpoint.
sdk_ua_app_id
class-attribute
instance-attribute
¶
sdk_ua_app_id: str | None = None
A unique and opaque application ID that is appended to the User-Agent header.
user_agent_extra
class-attribute
instance-attribute
¶
user_agent_extra: str | None = None
Additional suffix to be added to the User-Agent header.
Methods:¶
resolve
async
classmethod
¶
resolve(*, profile: str | None = None, fs: FileSystem | None = None, config_file_path: str | None = None, credentials_file_path: str | None = None, **overrides: Unpack[_AsyncBedrockConfigOverrides]) -> Self
Resolve config from environment, config files, defaults, and explicit overrides.
Plugin
module-attribute
¶
Plugin: TypeAlias = Callable[[AsyncBedrockConfig], None]
A callable that customizes a client configuration. Service-level plugins are applied once to the base configuration inherited by every operation. Operation-level plugins apply only to a single operation invocation.
Structures¶
AccountEnforcedGuardrailInferenceInputConfigurationAccountEnforcedGuardrailOutputConfigurationAdvancedPromptOptimizationInputConfigAdvancedPromptOptimizationJobSummaryAdvancedPromptOptimizationOutputConfigAgreementAvailabilityAutomatedEvaluationConfigAutomatedEvaluationCustomMetricConfigAutomatedReasoningCheckImpossibleFindingAutomatedReasoningCheckInputTextReferenceAutomatedReasoningCheckInvalidFindingAutomatedReasoningCheckLogicWarningAutomatedReasoningCheckNoTranslationsFindingAutomatedReasoningCheckRuleAutomatedReasoningCheckSatisfiableFindingAutomatedReasoningCheckScenarioAutomatedReasoningCheckTooComplexFindingAutomatedReasoningCheckTranslationAutomatedReasoningCheckTranslationAmbiguousFindingAutomatedReasoningCheckTranslationOptionAutomatedReasoningCheckValidFindingAutomatedReasoningLogicStatementAutomatedReasoningPolicyAddRuleAnnotationAutomatedReasoningPolicyAddRuleFromNaturalLanguageAnnotationAutomatedReasoningPolicyAddRuleMutationAutomatedReasoningPolicyAddTypeAnnotationAutomatedReasoningPolicyAddTypeMutationAutomatedReasoningPolicyAddTypeValueAutomatedReasoningPolicyAddVariableAnnotationAutomatedReasoningPolicyAddVariableMutationAutomatedReasoningPolicyAnnotatedChunkAutomatedReasoningPolicyAnnotatedLineAutomatedReasoningPolicyAtomicStatementAutomatedReasoningPolicyBuildLogAutomatedReasoningPolicyBuildLogEntryAutomatedReasoningPolicyBuildResultAssetManifestAutomatedReasoningPolicyBuildResultAssetManifestEntryAutomatedReasoningPolicyBuildStepAutomatedReasoningPolicyBuildStepMessageAutomatedReasoningPolicyBuildWorkflowDocumentAutomatedReasoningPolicyBuildWorkflowRepairContentAutomatedReasoningPolicyBuildWorkflowSourceAutomatedReasoningPolicyBuildWorkflowSummaryAutomatedReasoningPolicyDefinitionAutomatedReasoningPolicyDefinitionQualityReportAutomatedReasoningPolicyDefinitionRuleAutomatedReasoningPolicyDefinitionTypeAutomatedReasoningPolicyDefinitionTypeValueAutomatedReasoningPolicyDefinitionTypeValuePairAutomatedReasoningPolicyDefinitionVariableAutomatedReasoningPolicyDeleteRuleAnnotationAutomatedReasoningPolicyDeleteRuleMutationAutomatedReasoningPolicyDeleteTypeAnnotationAutomatedReasoningPolicyDeleteTypeMutationAutomatedReasoningPolicyDeleteTypeValueAutomatedReasoningPolicyDeleteVariableAnnotationAutomatedReasoningPolicyDeleteVariableMutationAutomatedReasoningPolicyDisjointRuleSetAutomatedReasoningPolicyFidelityReportAutomatedReasoningPolicyGeneratedTestCaseAutomatedReasoningPolicyGeneratedTestCasesAutomatedReasoningPolicyIngestContentAnnotationAutomatedReasoningPolicyIterativeRefinementContentAutomatedReasoningPolicyPlanningAutomatedReasoningPolicyReportSourceDocumentAutomatedReasoningPolicyRuleReportAutomatedReasoningPolicyScenarioAutomatedReasoningPolicyScenariosAutomatedReasoningPolicySourceDocumentAutomatedReasoningPolicyStatementLocationAutomatedReasoningPolicyStatementReferenceAutomatedReasoningPolicySummaryAutomatedReasoningPolicyTestCaseAutomatedReasoningPolicyTestResultAutomatedReasoningPolicyUpdateFromRuleFeedbackAnnotationAutomatedReasoningPolicyUpdateFromScenarioFeedbackAnnotationAutomatedReasoningPolicyUpdateRuleAnnotationAutomatedReasoningPolicyUpdateRuleMutationAutomatedReasoningPolicyUpdateTypeAnnotationAutomatedReasoningPolicyUpdateTypeMutationAutomatedReasoningPolicyUpdateTypeValueAutomatedReasoningPolicyUpdateVariableAnnotationAutomatedReasoningPolicyUpdateVariableMutationAutomatedReasoningPolicyVariableReportBatchDeleteAdvancedPromptOptimizationJobErrorBatchDeleteAdvancedPromptOptimizationJobItemBatchDeleteEvaluationJobErrorBatchDeleteEvaluationJobItemBedrockEvaluatorModelByteContentDocCloudWatchConfigCustomMetricBedrockEvaluatorModelCustomMetricDefinitionCustomMetricEvaluatorModelConfigCustomModelDeploymentSummaryCustomModelDeploymentUpdateDetailsCustomModelSummaryCustomModelUnitsDataProcessingDetailsDimensionalPriceRateDistillationConfigEvaluationBedrockModelEvaluationDatasetEvaluationDatasetMetricConfigEvaluationInferenceConfigSummaryEvaluationModelConfigSummaryEvaluationOutputDataConfigEvaluationPrecomputedInferenceSourceEvaluationPrecomputedRetrieveAndGenerateSourceConfigEvaluationPrecomputedRetrieveSourceConfigEvaluationRagConfigSummaryEvaluationSummaryExternalSourceExternalSourcesGenerationConfigurationExternalSourcesRetrieveAndGenerateConfigurationFieldForRerankingFilterAttributeFoundationModelDetailsFoundationModelLifecycleFoundationModelSummaryGenerationConfigurationGuardrailAutomatedReasoningPolicyGuardrailAutomatedReasoningPolicyConfigGuardrailConfigurationGuardrailContentFilterGuardrailContentFilterConfigGuardrailContentFiltersTierGuardrailContentFiltersTierConfigGuardrailContentPolicyGuardrailContentPolicyConfigGuardrailContextualGroundingFilterGuardrailContextualGroundingFilterConfigGuardrailContextualGroundingPolicyGuardrailContextualGroundingPolicyConfigGuardrailCrossRegionConfigGuardrailCrossRegionDetailsGuardrailManagedWordsGuardrailManagedWordsConfigGuardrailPiiEntityGuardrailPiiEntityConfigGuardrailRegexGuardrailRegexConfigGuardrailSensitiveInformationPolicyGuardrailSensitiveInformationPolicyConfigGuardrailSummaryGuardrailTopicGuardrailTopicConfigGuardrailTopicPolicyGuardrailTopicPolicyConfigGuardrailTopicsTierGuardrailTopicsTierConfigGuardrailWordGuardrailWordConfigGuardrailWordPolicyGuardrailWordPolicyConfigHumanEvaluationConfigHumanEvaluationCustomMetricHumanWorkflowConfigImplicitFilterConfigurationImportedModelSummaryInferenceConfigurationInferenceProfileModelInferenceProfileSummaryInvocationLogsConfigKbInferenceConfigKnowledgeBaseRetrievalConfigurationKnowledgeBaseRetrieveAndGenerateConfigurationKnowledgeBaseVectorSearchConfigurationLambdaGraderConfigLegalTermLoggingConfigMarketplaceModelEndpointMarketplaceModelEndpointSummaryMetadataAttributeSchemaMetadataConfigurationForRerankingModelConfigurationModelCopyJobSummaryModelCustomizationJobSummaryModelEnforcementModelImportJobSummaryModelInvocationJobS3InputDataConfigModelInvocationJobS3OutputDataConfigModelInvocationJobSummaryModelPackageArnDataSourceOfferOrchestrationConfigurationOutputDataConfigPerformanceConfigurationPricingTermPromptRouterSummaryPromptRouterTargetModelPromptTemplateProvisionedModelSummaryQueryTransformationConfigurationRFTConfigRFTHyperParametersRatingScaleItemRequestMetadataBaseFiltersRetrieveAndGenerateConfigurationRetrieveConfigRoutingCriteriaS3ConfigS3DataSourceS3ObjectDocSageMakerEndpointSelectiveContentGuardingStatusDetailsSupportTermTagTeacherModelConfigTermDetailsTextInferenceConfigTrainingDataConfigTrainingDetailsTrainingMetricsValidationDataConfigValidationDetailsValidatorValidatorMetricValidityTermVectorSearchBedrockRerankingConfigurationVectorSearchBedrockRerankingModelConfigurationVectorSearchRerankingConfigurationVpcConfig
Errors¶
AccessDeniedExceptionConflictExceptionInternalServerExceptionResourceInUseExceptionResourceNotFoundExceptionServiceErrorServiceQuotaExceededExceptionServiceUnavailableExceptionThrottlingExceptionTooManyTagsExceptionValidationException
Unions¶
AutomatedEvaluationCustomMetricSourceAutomatedReasoningCheckFindingAutomatedReasoningPolicyAnnotatedContentAutomatedReasoningPolicyAnnotationAutomatedReasoningPolicyBuildResultAssetsAutomatedReasoningPolicyBuildStepContextAutomatedReasoningPolicyDefinitionElementAutomatedReasoningPolicyGenerateFidelityReportContentAutomatedReasoningPolicyMutationAutomatedReasoningPolicyTypeValueAnnotationAutomatedReasoningPolicyWorkflowTypeContentCustomModelDataSourceCustomizationConfigEndpointConfigEvaluationConfigEvaluationDatasetLocationEvaluationInferenceConfigEvaluationModelConfigEvaluationPrecomputedRagSourceConfigEvaluatorModelConfigGraderConfigInferenceProfileModelSourceInvocationLogSourceKnowledgeBaseConfigModelDataSourceModelInvocationJobInputDataConfigModelInvocationJobOutputDataConfigRAGConfigRatingScaleItemValueRequestMetadataFiltersRerankingMetadataSelectiveModeConfigurationRetrievalFilter
Enums¶
AdvancedPromptOptimizationJobStatusAgreementStatusApplicationTypeAttributeTypeAuthorizationStatusAutomatedReasoningCheckLogicWarningTypeAutomatedReasoningCheckResultAutomatedReasoningPolicyAnnotationStatusAutomatedReasoningPolicyBuildDocumentContentTypeAutomatedReasoningPolicyBuildMessageTypeAutomatedReasoningPolicyBuildResultAssetTypeAutomatedReasoningPolicyBuildWorkflowStatusAutomatedReasoningPolicyBuildWorkflowTypeAutomatedReasoningPolicyTestRunResultAutomatedReasoningPolicyTestRunStatusCommitmentDurationCustomModelDeploymentStatusCustomModelDeploymentUpdateStatusCustomizationTypeDataRetentionModeEntitlementAvailabilityEvaluationJobStatusEvaluationJobTypeEvaluationTaskTypeExternalSourceTypeFineTuningJobStatusFoundationModelLifecycleStatusGuardrailContentFilterActionGuardrailContentFilterTypeGuardrailContentFiltersTierNameGuardrailContextualGroundingActionGuardrailContextualGroundingFilterTypeGuardrailFilterStrengthGuardrailManagedWordsTypeGuardrailModalityGuardrailPiiEntityTypeGuardrailSensitiveInformationActionGuardrailStatusGuardrailTopicActionGuardrailTopicTypeGuardrailTopicsTierNameGuardrailWordActionInferenceProfileStatusInferenceProfileTypeInferenceTypeInputTagsJobStatusDetailsModelCopyJobStatusModelCustomizationModelCustomizationJobStatusModelImportJobStatusModelInvocationJobStatusModelInvocationTypeModelModalityModelStatusOfferTypePerformanceConfigLatencyPromptRouterStatusPromptRouterTypeProvisionedModelStatusQueryTransformationTypeReasoningEffortRegionAvailabilityRerankingMetadataSelectionModeRetrieveAndGenerateTypeS3InputFormatSearchTypeSelectiveGuardingModeSortByProvisionedModelsSortJobsBySortModelsBySortOrderStatusVectorSearchRerankingConfigurationType