View a markdown version of this page

PutOrganizationDataRetentionStorage - Amazon Bedrock

PutOrganizationDataRetentionStorage

Creates or replaces the organization's retention storage record for a model provider. The organization is resolved from the authenticated caller's management context; the caller must be the organization's management account or a delegated administrator. Requires resolved organization-scope trusted access eligibility for a storage-capable program of the provider; otherwise returns ConflictException. Writes replace the whole record; the last write wins.

For customer_managed destinations, Amazon Bedrock validates the caller's and service's access to the bucket and key before saving the configuration. The bucket and key must be in the AWS Region where you register the configuration. Validation failures reject the write.

Request Syntax

PUT /v1/data_retention/organization-storage/modelProvider HTTP/1.1 Content-type: application/json { "storageConfiguration": { "kmsKeyArn": "string", "s3BucketArn": "string", "s3BucketOwner": "string" }, "storageDestination": "string" }

URI Request Parameters

The request uses the following URI parameters.

modelProvider

The model provider whose retention storage configuration is addressed by this request.

Valid Values: anthropic | openai

Required: Yes

Request Body

The request accepts the following data in JSON format.

storageConfiguration

Destination bucket and key. Required when storageDestination is customer_managed; rejected with ValidationException when amazon_managed.

Type: DataRetentionStorageConfiguration object

Required: No

storageDestination

Where retained data is delivered for this scope. customer_managed requires storageConfiguration; amazon_managed forbids it.

Type: String

Valid Values: customer_managed | amazon_managed

Required: Yes

Response Syntax

HTTP/1.1 200 Content-type: application/json { "kmsKeyStatus": "string", "modelProvider": "string", "s3BucketStatus": "string", "scope": "string", "storageConfiguration": { "kmsKeyArn": "string", "s3BucketArn": "string", "s3BucketOwner": "string" }, "storageDestination": "string", "updatedAt": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

kmsKeyStatus

Validation state of the KMS key. Present only when storageDestination is customer_managed.

Type: String

Valid Values: pending | active | access_denied

modelProvider

Model provider this configuration applies to.

Type: String

Valid Values: anthropic | openai

s3BucketStatus

Validation state of the bucket. Present only when storageDestination is customer_managed.

Type: String

Valid Values: pending | active | access_denied

scope

Scope addressed by the operation that returned this record.

Type: String

Valid Values: account | organization | project

storageConfiguration

The stored destination and key. Present only when storageDestination is customer_managed.

Type: DataRetentionStorageConfiguration object

storageDestination

Where this record delivers retained data.

Type: String

Valid Values: customer_managed | amazon_managed

updatedAt

Time the stored record last changed.

Type: Timestamp

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

The request is denied because of missing access permissions.

HTTP Status Code: 403

ConflictException

Error occurred because of a conflict while performing an operation.

HTTP Status Code: 400

InternalServerException

An internal server error occurred. Retry your request.

HTTP Status Code: 500

ThrottlingException

The number of requests exceeds the limit. Resubmit your request later.

HTTP Status Code: 429

ValidationException

Input validation failed. Check your request parameters and retry the request.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: