aws-sdk 2.1604.0 → 2.1606.0

package/clients/bedrockagent.d.ts

@@ -811,6 +811,7 @@ declare namespace BedrockAgent {
   export type BasePromptTemplate = string;
   export type BedrockEmbeddingModelArn = string;
   export type Boolean = boolean;
+  export type BucketOwnerAccountId = string;
   export interface ChunkingConfiguration {
     /**
      * Knowledge base can split your source data into chunks. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for NONE, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.    FIXED_SIZE – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the fixedSizeChunkingConfiguration.    NONE – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.  
@@ -957,6 +958,10 @@ declare namespace BedrockAgent {
      * A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.
      */
     clientToken?: ClientToken;
+    /**
+     * The deletion policy for the requested data source
+     */
+    dataDeletionPolicy?: DataDeletionPolicy;
     /**
      * Contains metadata about where the data source is stored.
      */
@@ -1026,11 +1031,16 @@ declare namespace BedrockAgent {
   }
   export type CreationMode = "DEFAULT"|"OVERRIDDEN"|string;
   export type CustomControlMethod = "RETURN_CONTROL"|string;
+  export type DataDeletionPolicy = "RETAIN"|"DELETE"|string;
   export interface DataSource {
     /**
      * The time at which the data source was created.
      */
     createdAt: DateTimestamp;
+    /**
+     * The deletion policy for the data source.
+     */
+    dataDeletionPolicy?: DataDeletionPolicy;
     /**
      * Contains details about how the data source is stored.
      */
@@ -1043,6 +1053,10 @@ declare namespace BedrockAgent {
      * The description of the data source.
      */
     description?: Description;
+    /**
+     * The details of the failure reasons related to the data source.
+     */
+    failureReasons?: FailureReasons;
     /**
      * The unique identifier of the knowledge base to which the data source belongs.
      */
@@ -1078,7 +1092,7 @@ declare namespace BedrockAgent {
      */
     type: DataSourceType;
   }
-  export type DataSourceStatus = "AVAILABLE"|"DELETING"|string;
+  export type DataSourceStatus = "AVAILABLE"|"DELETING"|"DELETE_UNSUCCESSFUL"|string;
   export type DataSourceSummaries = DataSourceSummary[];
   export interface DataSourceSummary {
     /**
@@ -1645,7 +1659,7 @@ declare namespace BedrockAgent {
   }
   export type KnowledgeBaseRoleArn = string;
   export type KnowledgeBaseState = "ENABLED"|"DISABLED"|string;
-  export type KnowledgeBaseStatus = "CREATING"|"ACTIVE"|"DELETING"|"UPDATING"|"FAILED"|string;
+  export type KnowledgeBaseStatus = "CREATING"|"ACTIVE"|"DELETING"|"UPDATING"|"FAILED"|"DELETE_UNSUCCESSFUL"|string;
   export type KnowledgeBaseStorageType = "OPENSEARCH_SERVERLESS"|"PINECONE"|"REDIS_ENTERPRISE_CLOUD"|"RDS"|string;
   export type KnowledgeBaseSummaries = KnowledgeBaseSummary[];
   export interface KnowledgeBaseSummary {
@@ -2121,6 +2135,10 @@ declare namespace BedrockAgent {
      * The Amazon Resource Name (ARN) of the bucket that contains the data source.
      */
     bucketArn: S3BucketArn;
+    /**
+     * The account ID for the owner of the S3 bucket.
+     */
+    bucketOwnerAccountId?: BucketOwnerAccountId;
     /**
      * A list of S3 prefixes that define the object containing the data sources. For more information, see Organizing objects using prefixes.
      */
@@ -2378,6 +2396,10 @@ declare namespace BedrockAgent {
     agent: Agent;
   }
   export interface UpdateDataSourceRequest {
+    /**
+     * The data deletion policy of the updated data source.
+     */
+    dataDeletionPolicy?: DataDeletionPolicy;
     /**
      * Contains details about the storage configuration of the data source.
      */

package/clients/bedrockagentruntime.d.ts

@@ -164,6 +164,21 @@ declare namespace BedrockAgentRuntime {
   }
   export type BedrockModelArn = string;
   export type Boolean = boolean;
+  export type ByteContentBlob = Buffer|Uint8Array|Blob|string;
+  export interface ByteContentDoc {
+    /**
+     * The MIME type of the document contained in the wrapper object.
+     */
+    contentType: ContentType;
+    /**
+     * The byte value of the file to upload, encoded as a Base-64 string.
+     */
+    data: ByteContentBlob;
+    /**
+     * The file name of the document contained in the wrapper object.
+     */
+    identifier: Identifier;
+  }
   export interface Citation {
     /**
      * Contains the generated response and metadata 
@@ -185,6 +200,7 @@ declare namespace BedrockAgentRuntime {
     body?: String;
   }
   export type ContentMap = {[key: string]: Parameters};
+  export type ContentType = string;
   export type CreationMode = "DEFAULT"|"OVERRIDDEN"|string;
   export interface DependencyFailedException {
     message?: NonBlankString;
@@ -194,6 +210,42 @@ declare namespace BedrockAgentRuntime {
     resourceName?: NonBlankString;
   }
   export type Double = number;
+  export interface ExternalSource {
+    /**
+     * The identifier, contentType, and data of the external source wrapper object.
+     */
+    byteContent?: ByteContentDoc;
+    /**
+     * The S3 location of the external source wrapper object.
+     */
+    s3Location?: S3ObjectDoc;
+    /**
+     * The source type of the external source wrapper object.
+     */
+    sourceType: ExternalSourceType;
+  }
+  export type ExternalSourceType = "S3"|"BYTE_CONTENT"|string;
+  export type ExternalSources = ExternalSource[];
+  export interface ExternalSourcesGenerationConfiguration {
+    /**
+     * Contain the textPromptTemplate string for the external source wrapper object.
+     */
+    promptTemplate?: PromptTemplate;
+  }
+  export interface ExternalSourcesRetrieveAndGenerateConfiguration {
+    /**
+     * The prompt used with the external source wrapper object with the retrieveAndGenerate function.
+     */
+    generationConfiguration?: ExternalSourcesGenerationConfiguration;
+    /**
+     * The modelArn used with the external source wrapper object in the retrieveAndGenerate function.
+     */
+    modelArn: BedrockModelArn;
+    /**
+     * The document used with the external source wrapper object in the retrieveAndGenerate function.
+     */
+    sources: ExternalSources;
+  }
   export type FailureReasonString = string;
   export interface FailureTrace {
     /**
@@ -285,6 +337,7 @@ declare namespace BedrockAgentRuntime {
      */
     promptTemplate?: PromptTemplate;
   }
+  export type Identifier = string;
   export interface InferenceConfiguration {
     /**
      * The maximum number of tokens allowed in the generated response.
@@ -766,6 +819,10 @@ declare namespace BedrockAgentRuntime {
     uri?: String;
   }
   export interface RetrieveAndGenerateConfiguration {
+    /**
+     * The configuration used with the external source wrapper object in the retrieveAndGenerate function.
+     */
+    externalSourcesConfiguration?: ExternalSourcesRetrieveAndGenerateConfiguration;
     /**
      * Contains details about the resource being queried.
      */
@@ -826,7 +883,7 @@ declare namespace BedrockAgentRuntime {
      */
     kmsKeyArn: KmsKeyArn;
   }
-  export type RetrieveAndGenerateType = "KNOWLEDGE_BASE"|string;
+  export type RetrieveAndGenerateType = "KNOWLEDGE_BASE"|"EXTERNAL_SOURCES"|string;
   export interface RetrieveRequest {
     /**
      * The unique identifier of the knowledge base to query.
@@ -881,6 +938,13 @@ declare namespace BedrockAgentRuntime {
      */
     invocationInputs?: InvocationInputs;
   }
+  export interface S3ObjectDoc {
+    /**
+     * The file location of the S3 wrapper object.
+     */
+    uri: S3Uri;
+  }
+  export type S3Uri = string;
   export type SearchType = "HYBRID"|"SEMANTIC"|string;
   export interface ServiceQuotaExceededException {
     message?: NonBlankString;

package/clients/bedrockruntime.d.ts

@@ -13,31 +13,33 @@ declare class BedrockRuntime extends Service {
   constructor(options?: BedrockRuntime.Types.ClientConfiguration)
   config: Config & BedrockRuntime.Types.ClientConfiguration;
   /**
-   * Invokes the specified Bedrock model to run inference using the input provided in the request body. You use InvokeModel to run inference for text models, image models, and embedding models. For more information, see Run inference in the Bedrock User Guide. For example requests, see Examples (after the Errors section).
+   * Invokes the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body. You use model inference to generate text, images, and embeddings. For example code, see Invoke model code examples in the Amazon Bedrock User Guide.  This operation requires permission for the bedrock:InvokeModel action.
    */
   invokeModel(params: BedrockRuntime.Types.InvokeModelRequest, callback?: (err: AWSError, data: BedrockRuntime.Types.InvokeModelResponse) => void): Request<BedrockRuntime.Types.InvokeModelResponse, AWSError>;
   /**
-   * Invokes the specified Bedrock model to run inference using the input provided in the request body. You use InvokeModel to run inference for text models, image models, and embedding models. For more information, see Run inference in the Bedrock User Guide. For example requests, see Examples (after the Errors section).
+   * Invokes the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body. You use model inference to generate text, images, and embeddings. For example code, see Invoke model code examples in the Amazon Bedrock User Guide.  This operation requires permission for the bedrock:InvokeModel action.
    */
   invokeModel(callback?: (err: AWSError, data: BedrockRuntime.Types.InvokeModelResponse) => void): Request<BedrockRuntime.Types.InvokeModelResponse, AWSError>;
   /**
-   * Invoke the specified Bedrock model to run inference using the input provided. Return the response in a stream. For more information, see Run inference in the Bedrock User Guide. For an example request and response, see Examples (after the Errors section).
+   * Invoke the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body. The response is returned in a stream. To see if a model supports streaming, call GetFoundationModel and check the responseStreamingSupported field in the response.  The CLI doesn't support InvokeModelWithResponseStream.  For example code, see Invoke model with streaming code example in the Amazon Bedrock User Guide.  This operation requires permissions to perform the bedrock:InvokeModelWithResponseStream action. 
    */
   invokeModelWithResponseStream(params: BedrockRuntime.Types.InvokeModelWithResponseStreamRequest, callback?: (err: AWSError, data: BedrockRuntime.Types.InvokeModelWithResponseStreamResponse) => void): Request<BedrockRuntime.Types.InvokeModelWithResponseStreamResponse, AWSError>;
   /**
-   * Invoke the specified Bedrock model to run inference using the input provided. Return the response in a stream. For more information, see Run inference in the Bedrock User Guide. For an example request and response, see Examples (after the Errors section).
+   * Invoke the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body. The response is returned in a stream. To see if a model supports streaming, call GetFoundationModel and check the responseStreamingSupported field in the response.  The CLI doesn't support InvokeModelWithResponseStream.  For example code, see Invoke model with streaming code example in the Amazon Bedrock User Guide.  This operation requires permissions to perform the bedrock:InvokeModelWithResponseStream action. 
    */
   invokeModelWithResponseStream(callback?: (err: AWSError, data: BedrockRuntime.Types.InvokeModelWithResponseStreamResponse) => void): Request<BedrockRuntime.Types.InvokeModelWithResponseStreamResponse, AWSError>;
 }
 declare namespace BedrockRuntime {
   export type Body = Buffer|Uint8Array|Blob|string;
+  export type GuardrailIdentifier = string;
+  export type GuardrailVersion = string;
   export interface InternalServerException {
     message?: NonBlankString;
   }
   export type InvokeModelIdentifier = string;
   export interface InvokeModelRequest {
     /**
-     * Input data in the format specified in the content-type request header. To see the format and content of this field for different models, refer to Inference parameters.
+     * The prompt and inference parameters in the format specified in the contentType in the header. To see the format and content of the request and response bodies for different models, refer to Inference parameters. For more information, see Run inference in the Bedrock User Guide.
      */
     body: Body;
     /**
@@ -49,13 +51,25 @@ declare namespace BedrockRuntime {
      */
     accept?: MimeType;
     /**
-     * Identifier of the model. 
+     * The unique identifier of the model to invoke to run inference. The modelId to provide depends on the type of model that you use:   If you use a base model, specify the model ID or its ARN. For a list of model IDs for base models, see Amazon Bedrock base model IDs (on-demand throughput) in the Amazon Bedrock User Guide.   If you use a provisioned model, specify the ARN of the Provisioned Throughput. For more information, see Run inference using a Provisioned Throughput in the Amazon Bedrock User Guide.   If you use a custom model, first purchase Provisioned Throughput for it. Then specify the ARN of the resulting provisioned model. For more information, see Use a custom model in Amazon Bedrock in the Amazon Bedrock User Guide.  
      */
     modelId: InvokeModelIdentifier;
+    /**
+     * Specifies whether to enable or disable the Bedrock trace. If enabled, you can see the full Bedrock trace.
+     */
+    trace?: Trace;
+    /**
+     * The unique identifier of the guardrail that you want to use. If you don't provide a value, no guardrail is applied to the invocation. An error will be thrown in the following situations.   You don't provide a guardrail identifier but you specify the amazon-bedrock-guardrailConfig field in the request body.   You enable the guardrail but the contentType isn't application/json.   You provide a guardrail identifier, but guardrailVersion isn't specified.  
+     */
+    guardrailIdentifier?: GuardrailIdentifier;
+    /**
+     * The version number for the guardrail. The value can also be DRAFT.
+     */
+    guardrailVersion?: GuardrailVersion;
   }
   export interface InvokeModelResponse {
     /**
-     * Inference response from the model in the format specified in the content-type header field. To see the format and content of this field for different models, refer to Inference parameters.
+     * Inference response from the model in the format specified in the contentType header. To see the format and content of the request and response bodies for different models, refer to Inference parameters.
      */
     body: Body;
     /**
@@ -65,7 +79,7 @@ declare namespace BedrockRuntime {
   }
   export interface InvokeModelWithResponseStreamRequest {
     /**
-     * Inference input in the format specified by the content-type. To see the format and content of this field for different models, refer to Inference parameters.
+     * The prompt and inference parameters in the format specified in the contentType in the header. To see the format and content of the request and response bodies for different models, refer to Inference parameters. For more information, see Run inference in the Bedrock User Guide.
      */
     body: Body;
     /**
@@ -77,13 +91,25 @@ declare namespace BedrockRuntime {
      */
     accept?: MimeType;
     /**
-     * Id of the model to invoke using the streaming request.
+     * The unique identifier of the model to invoke to run inference. The modelId to provide depends on the type of model that you use:   If you use a base model, specify the model ID or its ARN. For a list of model IDs for base models, see Amazon Bedrock base model IDs (on-demand throughput) in the Amazon Bedrock User Guide.   If you use a provisioned model, specify the ARN of the Provisioned Throughput. For more information, see Run inference using a Provisioned Throughput in the Amazon Bedrock User Guide.   If you use a custom model, first purchase Provisioned Throughput for it. Then specify the ARN of the resulting provisioned model. For more information, see Use a custom model in Amazon Bedrock in the Amazon Bedrock User Guide.  
      */
     modelId: InvokeModelIdentifier;
+    /**
+     * Specifies whether to enable or disable the Bedrock trace. If enabled, you can see the full Bedrock trace.
+     */
+    trace?: Trace;
+    /**
+     * The unique identifier of the guardrail that you want to use. If you don't provide a value, no guardrail is applied to the invocation. An error is thrown in the following situations.   You don't provide a guardrail identifier but you specify the amazon-bedrock-guardrailConfig field in the request body.   You enable the guardrail but the contentType isn't application/json.   You provide a guardrail identifier, but guardrailVersion isn't specified.  
+     */
+    guardrailIdentifier?: GuardrailIdentifier;
+    /**
+     * The version number for the guardrail. The value can also be DRAFT.
+     */
+    guardrailVersion?: GuardrailVersion;
   }
   export interface InvokeModelWithResponseStreamResponse {
     /**
-     * Inference response from the model in the format specified by Content-Type. To see the format and content of this field for different models, refer to Inference parameters.
+     * Inference response from the model in the format specified by the contentType header. To see the format and content of this field for different models, refer to Inference parameters.
      */
     body: ResponseStream;
     /**
@@ -119,6 +145,7 @@ declare namespace BedrockRuntime {
   export interface ThrottlingException {
     message?: NonBlankString;
   }
+  export type Trace = "ENABLED"|"DISABLED"|string;
   export interface ValidationException {
     message?: NonBlankString;
   }

package/clients/costexplorer.d.ts

@@ -108,11 +108,11 @@ declare class CostExplorer extends Service {
    */
   getCostAndUsage(callback?: (err: AWSError, data: CostExplorer.Types.GetCostAndUsageResponse) => void): Request<CostExplorer.Types.GetCostAndUsageResponse, AWSError>;
   /**
-   * Retrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.  This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information about how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide. 
+   * Retrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. Hourly granularity is only available for EC2-Instances (Elastic Compute Cloud) resource-level data. All other resource-level data is available at daily granularity.  This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information about how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide. 
    */
   getCostAndUsageWithResources(params: CostExplorer.Types.GetCostAndUsageWithResourcesRequest, callback?: (err: AWSError, data: CostExplorer.Types.GetCostAndUsageWithResourcesResponse) => void): Request<CostExplorer.Types.GetCostAndUsageWithResourcesResponse, AWSError>;
   /**
-   * Retrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.  This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information about how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide. 
+   * Retrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. Hourly granularity is only available for EC2-Instances (Elastic Compute Cloud) resource-level data. All other resource-level data is available at daily granularity.  This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information about how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide. 
    */
   getCostAndUsageWithResources(callback?: (err: AWSError, data: CostExplorer.Types.GetCostAndUsageWithResourcesResponse) => void): Request<CostExplorer.Types.GetCostAndUsageWithResourcesResponse, AWSError>;
   /**
@@ -2678,13 +2678,17 @@ declare namespace CostExplorer {
   export type ReservationPurchaseRecommendationDetails = ReservationPurchaseRecommendationDetail[];
   export interface ReservationPurchaseRecommendationMetadata {
     /**
-     * The ID for this specific recommendation.
+     * The ID for the recommendation.
      */
     RecommendationId?: GenericString;
     /**
-     * The timestamp for when Amazon Web Services made this recommendation.
+     * The timestamp for when Amazon Web Services made the recommendation.
      */
     GenerationTimestamp?: GenericString;
+    /**
+     * Additional metadata that might be applicable to the recommendation.
+     */
+    AdditionalMetadata?: GenericString;
   }
   export interface ReservationPurchaseRecommendationSummary {
     /**
@@ -2806,15 +2810,15 @@ declare namespace CostExplorer {
   export type RightsizingRecommendationList = RightsizingRecommendation[];
   export interface RightsizingRecommendationMetadata {
     /**
-     * The ID for this specific recommendation.
+     * The ID for the recommendation.
      */
     RecommendationId?: GenericString;
     /**
-     * The timestamp for when Amazon Web Services made this recommendation.
+     * The timestamp for when Amazon Web Services made the recommendation.
      */
     GenerationTimestamp?: GenericString;
     /**
-     * The number of days of previous usage that Amazon Web Services considers when making this recommendation.
+     * The number of days of previous usage that Amazon Web Services considers when making the recommendation.
      */
     LookbackPeriodInDays?: LookbackPeriodInDays;
     /**