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