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 | openaiRequired: 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_managedRequired: 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: