用于创建和更新分配的必填 API 字段
与使用 CreateDistribution 创建分配相比，在使用 UpdateDistribution CloudFront API 操作更新分配时具有更多的必需字段。要更新分配，请完成以下步骤：
-
使用 GetDistribution 获取要更新的分配的当前配置。
-
修改要更新的分配配置中的字段。此外，将
ETag字段重命名为IfMatch，但不更改字段的值。 -
使用 UpdateDistribution 更新分配，同时提供整个分配配置，包括您修改的字段和未修改的字段。
下表汇总了创建和更新分配所需的字段。
DistributionConfig
| 成员 | 在 CreateDistribution API 调用中是必需的 | 在 UpdateDistribution API 调用中是必需的 |
|---|---|---|
CallerReference |
是 |
是 |
Aliases |
- |
是（此字段为必填字段，但数量为 |
DefaultRootObject |
- |
是（此字段为必填字段，但空字符串是有效值） |
Origins |
是 |
是 |
|
OriginGroups |
- |
- |
DefaultCacheBehavior |
是 |
是 |
CacheBehaviors |
- |
是（此字段为必填字段，但数量为 |
CustomErrorResponses |
- |
是（此字段为必填字段，但数量为 |
Comment |
是（此字段为必填字段，但空字符串是有效值） |
是（此字段为必填字段，但空字符串是有效值） |
Logging |
- |
是 |
PriceClass |
- |
是 |
Enabled |
是 |
是 |
ViewerCertificate |
- |
是 |
Restrictions |
- |
是（此字段为必填字段，但 |
WebACLId |
- |
是（此字段为必填字段，但空字符串是有效值） |
HttpVersion |
- |
是 |
IsIPV6Enabled |
- |
- |
CacheBehavior（包括 DefaultCacheBehavior）
| 成员 | 在 CreateDistribution API 调用中是必需的 | 在 UpdateDistribution API 调用中是必需的 |
|---|---|---|
PathPattern（此字段不适用于 DefaultCacheBehavior） |
是 |
是 |
TargetOriginId |
是 |
是 |
TrustedSigners |
- |
- |
|
TrustedKeyGroups |
- |
- |
ViewerProtocolPolicy |
是 |
是 |
AllowedMethods |
- |
是 |
SmoothStreaming |
- |
是 |
Compress |
- |
是 |
LambdaFunctionAssociations |
- |
是（此字段为必填字段，但数量为 |
|
FunctionAssociations |
- |
- |
FieldLevelEncryptionId |
- |
是（此字段为必填字段，但空字符串是有效值） |
|
RealtimeLogConfigArn |
- |
- |
|
CachePolicyId |
是（当您使用以下弃用的字段时，不需要 |
是（当您使用以下弃用的字段时，不需要 |
|
OriginRequestPolicyId |
- |
- |
|
ResponseHeadersPolicyId |
- |
- |