本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# ReplicaRegions
<a name="sam-property-webfunction-replicaregions"></a>

指定`MultiRegion`或 `PerRegion` Web 函数端点将函数复制到的区域。您可以指定区域代码和区域组列表，也可以指定包含区域并可选择排除其中一些区域的对象。

您可以在指定区域的任何地方使用以下区域组：
+ `US`: `us-east-1`, `us-east-2`, `us-west-1`, `us-west-2`
+ `EU`: `eu-west-1`, `eu-west-2`, `eu-west-3`, `eu-central-1`, `eu-north-1`
+ `AP`: `ap-south-1`, `ap-northeast-1`, `ap-northeast-2`, `ap-northeast-3`, `ap-southeast-1`, `ap-southeast-2`
+ `CA`: `ca-central-1`
+ `SA`: `sa-east-1`
+ `SPARSE_GLOBAL`: 每个大洲有一两个覆盖全球的区域，区域较少：`us-east-1`、`eu-west-1`、`eu-central-1`、`ap-northeast-1`、`ap-southeast-1`、`ap-southeast-2`、`sa-east-1`
+ `ALL_STANDARD`: `US`、、`EU``AP``CA`、和`SA`组中的每个区域（17 个区域）

## 语法
<a name="sam-property-webfunction-replicaregions-syntax"></a>

要在 AWS Serverless Application Model (AWS SAM) 模板中声明此实体，请使用以下语法。

### YAML
<a name="sam-property-webfunction-replicaregions-syntax.yaml"></a>

```
[ExcludeRegions](#sam-webfunction-replicaregions-excluderegions): {{List}}
[IncludeRegions](#sam-webfunction-replicaregions-includeregions): {{List}}
```

## Properties
<a name="sam-property-webfunction-replicaregions-properties"></a>

 `ExcludeRegions`   <a name="sam-webfunction-replicaregions-excluderegions"></a>
要从中删除的区域代码和区域组的列表`IncludeRegions`。您还必须指定`IncludeRegions`。条目不能是内部函数，也不能在`IncludeRegions`包含内部函数`ExcludeRegions`时使用。  
*类型*：列表  
*必需*：否  
*CloudFormation 兼容性*：此属性是独有的 AWS SAM ，没有 CloudFormation 等效属性。

 `IncludeRegions`   <a name="sam-webfunction-replicaregions-includeregions"></a>
要将函数复制到的区域代码和区域组的列表。列表本身不能是内在函数，但单个条目可以。  
*类型*：列表  
*必需*：否  
*CloudFormation 兼容性*：此属性类似于`AWS::Lambda::WebFunctionEndpoint`资源的`[Regions](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-regions)`属性。 AWS SAM 展开区域组并删除所有`ExcludeRegions`条目以生成区域列表。

## 示例
<a name="sam-property-webfunction-replicaregions-examples"></a>

### 地区列表
<a name="sam-property-webfunction-replicaregions-example-list"></a>

以下示例将函数复制到两个区域。

```
ReplicaRegions:
  - us-east-1
  - eu-west-1
```

### 包含排除项的区域组
<a name="sam-property-webfunction-replicaregions-example-exclude"></a>

以下示例将该函数复制到除`us-west-1`之外的美国地区。

```
ReplicaRegions:
  IncludeRegions:
    - US
  ExcludeRegions:
    - us-west-1
```