feat(client-bedrock): Enable cross-Region inference for Amazon Bedrock Guardrails by using the crossRegionConfig parameter when calling the CreateGuardrail or UpdateGuardrail operation.

awstools · awstools · commit 568eb19882b1 · 2025-05-13T18:16:05.000Z
diff --git a/clients/client-bedrock/src/commands/CreateGuardrailCommand.ts b/clients/client-bedrock/src/commands/CreateGuardrailCommand.ts
@@ -162,6 +162,9 @@ export interface CreateGuardrailCommandOutput extends CreateGuardrailResponse, _
  *       },
  *     ],
  *   },
+ *   crossRegionConfig: { // GuardrailCrossRegionConfig
+ *     guardrailProfileIdentifier: "STRING_VALUE", // required
+ *   },
  *   blockedInputMessaging: "STRING_VALUE", // required
  *   blockedOutputsMessaging: "STRING_VALUE", // required
  *   kmsKeyId: "STRING_VALUE",
diff --git a/clients/client-bedrock/src/commands/GetEvaluationJobCommand.ts b/clients/client-bedrock/src/commands/GetEvaluationJobCommand.ts
@@ -6,12 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { BedrockClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockClient";
 import { commonParams } from "../endpoint/EndpointParameters";
-import {
-  GetEvaluationJobRequest,
-  GetEvaluationJobRequestFilterSensitiveLog,
-  GetEvaluationJobResponse,
-  GetEvaluationJobResponseFilterSensitiveLog,
-} from "../models/models_0";
+import { GetEvaluationJobRequest, GetEvaluationJobRequestFilterSensitiveLog } from "../models/models_0";
+import { GetEvaluationJobResponse, GetEvaluationJobResponseFilterSensitiveLog } from "../models/models_1";
 import { de_GetEvaluationJobCommand, se_GetEvaluationJobCommand } from "../protocols/Aws_restJson1";
 
 /**
diff --git a/clients/client-bedrock/src/commands/GetGuardrailCommand.ts b/clients/client-bedrock/src/commands/GetGuardrailCommand.ts
@@ -137,6 +137,10 @@ export interface GetGuardrailCommandOutput extends GetGuardrailResponse, __Metad
  * //       },
  * //     ],
  * //   },
+ * //   crossRegionDetails: { // GuardrailCrossRegionDetails
+ * //     guardrailProfileId: "STRING_VALUE",
+ * //     guardrailProfileArn: "STRING_VALUE",
+ * //   },
  * //   createdAt: new Date("TIMESTAMP"), // required
  * //   updatedAt: new Date("TIMESTAMP"), // required
  * //   statusReasons: [ // GuardrailStatusReasons
diff --git a/clients/client-bedrock/src/commands/ListGuardrailsCommand.ts b/clients/client-bedrock/src/commands/ListGuardrailsCommand.ts
@@ -58,6 +58,10 @@ export interface ListGuardrailsCommandOutput extends ListGuardrailsResponse, __M
  * //       version: "STRING_VALUE", // required
  * //       createdAt: new Date("TIMESTAMP"), // required
  * //       updatedAt: new Date("TIMESTAMP"), // required
+ * //       crossRegionDetails: { // GuardrailCrossRegionDetails
+ * //         guardrailProfileId: "STRING_VALUE",
+ * //         guardrailProfileArn: "STRING_VALUE",
+ * //       },
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",
diff --git a/clients/client-bedrock/src/commands/UpdateGuardrailCommand.ts b/clients/client-bedrock/src/commands/UpdateGuardrailCommand.ts
@@ -168,6 +168,9 @@ export interface UpdateGuardrailCommandOutput extends UpdateGuardrailResponse, _
  *       },
  *     ],
  *   },
+ *   crossRegionConfig: { // GuardrailCrossRegionConfig
+ *     guardrailProfileIdentifier: "STRING_VALUE", // required
+ *   },
  *   blockedInputMessaging: "STRING_VALUE", // required
  *   blockedOutputsMessaging: "STRING_VALUE", // required
  *   kmsKeyId: "STRING_VALUE",
diff --git a/clients/client-bedrock/src/models/index.ts b/clients/client-bedrock/src/models/index.ts
@@ -1,2 +1,3 @@
 // smithy-typescript generated code
 export * from "./models_0";
+export * from "./models_1";
diff --git a/clients/client-bedrock/src/models/models_0.ts b/clients/client-bedrock/src/models/models_0.ts
@@ -2351,6 +2351,19 @@ export interface GuardrailContextualGroundingPolicyConfig {
   filtersConfig: GuardrailContextualGroundingFilterConfig[] | undefined;
 }
 
+/**
+ * <p>The system-defined guardrail profile that you're using with your guardrail. Guardrail profiles define the destination Amazon Web Services Regions where guardrail inference requests can be automatically routed. Using guardrail profiles helps maintain guardrail performance and reliability when demand increases.</p>
+ *          <p>For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region.html">Amazon Bedrock User Guide</a>.</p>
+ * @public
+ */
+export interface GuardrailCrossRegionConfig {
+  /**
+   * <p>The ID or Amazon Resource Name (ARN) of the guardrail profile that your guardrail is using. Guardrail profile availability depends on your current Amazon Web Services Region. For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region-support.html">Amazon Bedrock User Guide</a>.</p>
+   * @public
+   */
+  guardrailProfileIdentifier: string | undefined;
+}
+
 /**
  * @public
  * @enum
@@ -3243,6 +3256,13 @@ export interface CreateGuardrailRequest {
    */
   contextualGroundingPolicyConfig?: GuardrailContextualGroundingPolicyConfig | undefined;
 
+  /**
+   * <p>The system-defined guardrail profile that you're using with your guardrail. Guardrail profiles define the destination Amazon Web Services Regions where guardrail inference requests can be automatically routed.</p>
+   *          <p>For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region.html">Amazon Bedrock User Guide</a>.</p>
+   * @public
+   */
+  crossRegionConfig?: GuardrailCrossRegionConfig | undefined;
+
   /**
    * <p>The message to return when the guardrail blocks a prompt.</p>
    * @public
@@ -3618,6 +3638,26 @@ export interface GuardrailContextualGroundingPolicy {
   filters: GuardrailContextualGroundingFilter[] | undefined;
 }
 
+/**
+ * <p>Contains details about the system-defined guardrail profile that you're using with your guardrail for cross-Region inference.</p>
+ *          <p>For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region.html">Amazon Bedrock User Guide</a>.</p>
+ * @public
+ */
+export interface GuardrailCrossRegionDetails {
+  /**
+   * <p>The ID of the guardrail profile that your guardrail is using. Profile availability
+   *          depends on your current Amazon Web Services Region. For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region-support.html">Amazon Bedrock User Guide</a>.</p>
+   * @public
+   */
+  guardrailProfileId?: string | undefined;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the guardrail profile that you're using with your guardrail.</p>
+   * @public
+   */
+  guardrailProfileArn?: string | undefined;
+}
+
 /**
  * <p>The PII entity configured for the guardrail.</p>
  * @public
@@ -4135,6 +4175,12 @@ export interface GetGuardrailResponse {
    */
   contextualGroundingPolicy?: GuardrailContextualGroundingPolicy | undefined;
 
+  /**
+   * <p>Details about the system-defined guardrail profile that you're using with your guardrail, including the guardrail profile ID and Amazon Resource Name (ARN).</p>
+   * @public
+   */
+  crossRegionDetails?: GuardrailCrossRegionDetails | undefined;
+
   /**
    * <p>The date and time at which the guardrail was created.</p>
    * @public
@@ -4261,6 +4307,12 @@ export interface GuardrailSummary {
    * @public
    */
   updatedAt: Date | undefined;
+
+  /**
+   * <p>Details about the system-defined guardrail profile that you're using with your guardrail, including the guardrail profile ID and Amazon Resource Name (ARN).</p>
+   * @public
+   */
+  crossRegionDetails?: GuardrailCrossRegionDetails | undefined;
 }
 
 /**
@@ -4332,6 +4384,13 @@ export interface UpdateGuardrailRequest {
    */
   contextualGroundingPolicyConfig?: GuardrailContextualGroundingPolicyConfig | undefined;
 
+  /**
+   * <p>The system-defined guardrail profile that you're using with your guardrail. Guardrail profiles define the destination Amazon Web Services Regions where guardrail inference requests can be automatically routed.</p>
+   *          <p>For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region.html">Amazon Bedrock User Guide</a>.</p>
+   * @public
+   */
+  crossRegionConfig?: GuardrailCrossRegionConfig | undefined;
+
   /**
    * <p>The message to return when the guardrail blocks a prompt.</p>
    * @public
@@ -9409,96 +9468,6 @@ export interface CreateEvaluationJobRequest {
   outputDataConfig: EvaluationOutputDataConfig | undefined;
 }
 
-/**
- * @public
- */
-export interface GetEvaluationJobResponse {
-  /**
-   * <p>The name for the evaluation job.</p>
-   * @public
-   */
-  jobName: string | undefined;
-
-  /**
-   * <p>The current status of the evaluation job.</p>
-   * @public
-   */
-  status: EvaluationJobStatus | undefined;
-
-  /**
-   * <p>The Amazon Resource Name (ARN) of the evaluation job.</p>
-   * @public
-   */
-  jobArn: string | undefined;
-
-  /**
-   * <p>The description of the evaluation job.</p>
-   * @public
-   */
-  jobDescription?: string | undefined;
-
-  /**
-   * <p>The Amazon Resource Name (ARN) of the IAM service role used in the evaluation job.</p>
-   * @public
-   */
-  roleArn: string | undefined;
-
-  /**
-   * <p>The Amazon Resource Name (ARN) of the customer managed encryption key specified when the evaluation job was created.</p>
-   * @public
-   */
-  customerEncryptionKeyId?: string | undefined;
-
-  /**
-   * <p>Specifies whether the evaluation job is automated or human-based.</p>
-   * @public
-   */
-  jobType: EvaluationJobType | undefined;
-
-  /**
-   * <p>Specifies whether the evaluation job is for evaluating a model or evaluating a knowledge base (retrieval and response generation).</p>
-   * @public
-   */
-  applicationType?: ApplicationType | undefined;
-
-  /**
-   * <p>Contains the configuration details of either an automated or human-based evaluation job.</p>
-   * @public
-   */
-  evaluationConfig: EvaluationConfig | undefined;
-
-  /**
-   * <p>Contains the configuration details of the inference model used for the evaluation job. </p>
-   * @public
-   */
-  inferenceConfig: EvaluationInferenceConfig | undefined;
-
-  /**
-   * <p>Contains the configuration details of the Amazon S3 bucket for
-   *          storing the results of the evaluation job.</p>
-   * @public
-   */
-  outputDataConfig: EvaluationOutputDataConfig | undefined;
-
-  /**
-   * <p>The time the evaluation job was created.</p>
-   * @public
-   */
-  creationTime: Date | undefined;
-
-  /**
-   * <p>The time the evaluation job was last modified.</p>
-   * @public
-   */
-  lastModifiedTime?: Date | undefined;
-
-  /**
-   * <p>A list of strings that specify why the evaluation job failed to create.</p>
-   * @public
-   */
-  failureMessages?: string[] | undefined;
-}
-
 /**
  * @internal
  */
@@ -10302,13 +10271,3 @@ export const CreateEvaluationJobRequestFilterSensitiveLog = (obj: CreateEvaluati
   ...(obj.evaluationConfig && { evaluationConfig: EvaluationConfigFilterSensitiveLog(obj.evaluationConfig) }),
   ...(obj.inferenceConfig && { inferenceConfig: EvaluationInferenceConfigFilterSensitiveLog(obj.inferenceConfig) }),
 });
-
-/**
- * @internal
- */
-export const GetEvaluationJobResponseFilterSensitiveLog = (obj: GetEvaluationJobResponse): any => ({
-  ...obj,
-  ...(obj.jobDescription && { jobDescription: SENSITIVE_STRING }),
-  ...(obj.evaluationConfig && { evaluationConfig: EvaluationConfigFilterSensitiveLog(obj.evaluationConfig) }),
-  ...(obj.inferenceConfig && { inferenceConfig: EvaluationInferenceConfigFilterSensitiveLog(obj.inferenceConfig) }),
-});
diff --git a/clients/client-bedrock/src/models/models_1.ts b/clients/client-bedrock/src/models/models_1.ts
@@ -0,0 +1,113 @@
+// smithy-typescript generated code
+import { SENSITIVE_STRING } from "@smithy/smithy-client";
+
+import {
+  ApplicationType,
+  EvaluationConfig,
+  EvaluationConfigFilterSensitiveLog,
+  EvaluationInferenceConfig,
+  EvaluationInferenceConfigFilterSensitiveLog,
+  EvaluationJobStatus,
+  EvaluationJobType,
+  EvaluationOutputDataConfig,
+} from "./models_0";
+
+/**
+ * @public
+ */
+export interface GetEvaluationJobResponse {
+  /**
+   * <p>The name for the evaluation job.</p>
+   * @public
+   */
+  jobName: string | undefined;
+
+  /**
+   * <p>The current status of the evaluation job.</p>
+   * @public
+   */
+  status: EvaluationJobStatus | undefined;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the evaluation job.</p>
+   * @public
+   */
+  jobArn: string | undefined;
+
+  /**
+   * <p>The description of the evaluation job.</p>
+   * @public
+   */
+  jobDescription?: string | undefined;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the IAM service role used in the evaluation job.</p>
+   * @public
+   */
+  roleArn: string | undefined;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the customer managed encryption key specified when the evaluation job was created.</p>
+   * @public
+   */
+  customerEncryptionKeyId?: string | undefined;
+
+  /**
+   * <p>Specifies whether the evaluation job is automated or human-based.</p>
+   * @public
+   */
+  jobType: EvaluationJobType | undefined;
+
+  /**
+   * <p>Specifies whether the evaluation job is for evaluating a model or evaluating a knowledge base (retrieval and response generation).</p>
+   * @public
+   */
+  applicationType?: ApplicationType | undefined;
+
+  /**
+   * <p>Contains the configuration details of either an automated or human-based evaluation job.</p>
+   * @public
+   */
+  evaluationConfig: EvaluationConfig | undefined;
+
+  /**
+   * <p>Contains the configuration details of the inference model used for the evaluation job. </p>
+   * @public
+   */
+  inferenceConfig: EvaluationInferenceConfig | undefined;
+
+  /**
+   * <p>Contains the configuration details of the Amazon S3 bucket for
+   *          storing the results of the evaluation job.</p>
+   * @public
+   */
+  outputDataConfig: EvaluationOutputDataConfig | undefined;
+
+  /**
+   * <p>The time the evaluation job was created.</p>
+   * @public
+   */
+  creationTime: Date | undefined;
+
+  /**
+   * <p>The time the evaluation job was last modified.</p>
+   * @public
+   */
+  lastModifiedTime?: Date | undefined;
+
+  /**
+   * <p>A list of strings that specify why the evaluation job failed to create.</p>
+   * @public
+   */
+  failureMessages?: string[] | undefined;
+}
+
+/**
+ * @internal
+ */
+export const GetEvaluationJobResponseFilterSensitiveLog = (obj: GetEvaluationJobResponse): any => ({
+  ...obj,
+  ...(obj.jobDescription && { jobDescription: SENSITIVE_STRING }),
+  ...(obj.evaluationConfig && { evaluationConfig: EvaluationConfigFilterSensitiveLog(obj.evaluationConfig) }),
+  ...(obj.inferenceConfig && { inferenceConfig: EvaluationInferenceConfigFilterSensitiveLog(obj.inferenceConfig) }),
+});
diff --git a/clients/client-bedrock/src/protocols/Aws_restJson1.ts b/clients/client-bedrock/src/protocols/Aws_restJson1.ts
diff --git a/codegen/sdk-codegen/aws-models/bedrock.json b/codegen/sdk-codegen/aws-models/bedrock.json

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,3 @@`
`1`	`1`	`// smithy-typescript generated code`
`2`	`2`	`export * from "./models_0";`
	`3`	`+export * from "./models_1";`