2023/10/02 - Amazon Bedrock - 5 new api methods
Changes Provisioned throughput feature with Amazon and third-party base models, and update validators for model identifier and taggable resource ARNs.
List the provisioned capacities. For more information, see Provisioned throughput in the Bedrock User Guide.
See also: AWS API Documentation
Request Syntax
client.list_provisioned_model_throughputs( creationTimeAfter=datetime(2015, 1, 1), creationTimeBefore=datetime(2015, 1, 1), statusEquals='Creating'|'InService'|'Updating'|'Failed', modelArnEquals='string', nameContains='string', maxResults=123, nextToken='string', sortBy='CreationTime', sortOrder='Ascending'|'Descending' )
datetime
Return provisioned capacities created after the specified time.
datetime
Return provisioned capacities created before the specified time.
string
Return the list of provisioned capacities that match the specified status.
string
Return the list of provisioned capacities where their model ARN is equal to this parameter.
string
Return the list of provisioned capacities if their name contains these characters.
integer
THe maximum number of results to return in the response.
string
Continuation token from the previous response, for Bedrock to list the next set of results.
string
The field to sort by in the returned list of provisioned capacities.
string
The sort order of the results.
dict
Response Syntax
{ 'nextToken': 'string', 'provisionedModelSummaries': [ { 'provisionedModelName': 'string', 'provisionedModelArn': 'string', 'modelArn': 'string', 'desiredModelArn': 'string', 'foundationModelArn': 'string', 'modelUnits': 123, 'desiredModelUnits': 123, 'status': 'Creating'|'InService'|'Updating'|'Failed', 'commitmentDuration': 'OneMonth'|'SixMonths', 'commitmentExpirationTime': datetime(2015, 1, 1), 'creationTime': datetime(2015, 1, 1), 'lastModifiedTime': datetime(2015, 1, 1) }, ] }
Response Structure
(dict) --
nextToken (string) --
Continuation token for the next request to list the next set of results.
provisionedModelSummaries (list) --
List of summaries, one for each provisioned throughput in the response.
(dict) --
Set of fields associated with a provisioned throughput.
provisionedModelName (string) --
The name of the provisioned throughput.
provisionedModelArn (string) --
The ARN of the provisioned throughput.
modelArn (string) --
The ARN of the model associated with this provisioned throughput.
desiredModelArn (string) --
Desired model ARN.
foundationModelArn (string) --
Foundation model ARN.
modelUnits (integer) --
The number of model units allocated.
desiredModelUnits (integer) --
Desired model units.
status (string) --
Status of the provisioned throughput.
commitmentDuration (string) --
Commitment duration for the provisioned throughput.
commitmentExpirationTime (datetime) --
Commitment expiration time for the provisioned throughput.
creationTime (datetime) --
The time that this provisioned throughput was created.
lastModifiedTime (datetime) --
The time that this provisioned throughput was last modified.
Update a provisioned throughput. For more information, see Provisioned throughput in the Bedrock User Guide.
See also: AWS API Documentation
Request Syntax
client.update_provisioned_model_throughput( provisionedModelId='string', desiredProvisionedModelName='string', desiredModelId='string' )
string
[REQUIRED]
The ARN or name of the provisioned throughput to update.
string
The new name for this provisioned throughput.
string
The ARN of the new model to associate with this provisioned throughput.
dict
Response Syntax
{}
Response Structure
(dict) --
Get details for a provisioned throughput. For more information, see Provisioned throughput in the Bedrock User Guide.
See also: AWS API Documentation
Request Syntax
client.get_provisioned_model_throughput( provisionedModelId='string' )
string
[REQUIRED]
The ARN or name of the provisioned throughput.
dict
Response Syntax
{ 'modelUnits': 123, 'desiredModelUnits': 123, 'provisionedModelName': 'string', 'provisionedModelArn': 'string', 'modelArn': 'string', 'desiredModelArn': 'string', 'foundationModelArn': 'string', 'status': 'Creating'|'InService'|'Updating'|'Failed', 'creationTime': datetime(2015, 1, 1), 'lastModifiedTime': datetime(2015, 1, 1), 'failureMessage': 'string', 'commitmentDuration': 'OneMonth'|'SixMonths', 'commitmentExpirationTime': datetime(2015, 1, 1) }
Response Structure
(dict) --
modelUnits (integer) --
The current number of model units requested to be available for this provisioned throughput.
desiredModelUnits (integer) --
The desired number of model units that was requested to be available for this provisioned throughput.
provisionedModelName (string) --
The name of the provisioned throughput.
provisionedModelArn (string) --
The ARN of the provisioned throughput.
modelArn (string) --
The ARN or name of the model associated with this provisioned throughput.
desiredModelArn (string) --
The ARN of the new model to asssociate with this provisioned throughput.
foundationModelArn (string) --
ARN of the foundation model.
status (string) --
Status of the provisioned throughput.
creationTime (datetime) --
The timestamp of the creation time for this provisioned throughput.
lastModifiedTime (datetime) --
The timestamp of the last modified time of this provisioned throughput.
failureMessage (string) --
Failure message for any issues that the create operation encounters.
commitmentDuration (string) --
Commitment duration of the provisioned throughput.
commitmentExpirationTime (datetime) --
Commitment expiration time for the provisioned throughput.
Deletes a provisioned throughput. For more information, see Provisioned throughput in the Bedrock User Guide.
See also: AWS API Documentation
Request Syntax
client.delete_provisioned_model_throughput( provisionedModelId='string' )
string
[REQUIRED]
The ARN or name of the provisioned throughput.
dict
Response Syntax
{}
Response Structure
(dict) --
Creates a provisioned throughput with dedicated capacity for a foundation model or a fine-tuned model.
For more information, see Provisioned throughput in the Bedrock User Guide.
See also: AWS API Documentation
Request Syntax
client.create_provisioned_model_throughput( clientRequestToken='string', modelUnits=123, provisionedModelName='string', modelId='string', commitmentDuration='OneMonth'|'SixMonths', tags=[ { 'key': 'string', 'value': 'string' }, ] )
string
Unique token value that you can provide. If this token matches a previous request, Bedrock ignores the request, but does not return an error.
This field is autopopulated if not provided.
integer
[REQUIRED]
Number of model units to allocate.
string
[REQUIRED]
Unique name for this provisioned throughput.
string
[REQUIRED]
Name or ARN of the model to associate with this provisioned throughput.
string
Commitment duration requested for the provisioned throughput.
list
Tags to associate with this provisioned throughput.
(dict) --
Definition of the key/value pair for a tag.
key (string) -- [REQUIRED]
Key for the tag.
value (string) -- [REQUIRED]
Value for the tag.
dict
Response Syntax
{ 'provisionedModelArn': 'string' }
Response Structure
(dict) --
provisionedModelArn (string) --
The ARN for this provisioned throughput.