全部产品
Search
文档中心

专有网络 VPC:ReplaceVpcDhcpOptionsSet - 更改DHCP选项集与VPC的关联

更新时间:Aug 28, 2026

调用ReplaceVpcDhcpOptionsSet接口更改DHCP选项集与VPC的关联。

接口说明

  • ReplaceVpcDhcpOptionsSet 接口属于异步接口,即系统返回一个请求 ID,但该 DHCP 选项集尚未更改成功,系统后台的更改任务仍在进行。您可以调用 DescribeVpcAttribute 查询 DHCP 选项集的更改状态:
    • 当 DHCP 选项集处于 Pending 状态时,表示 DHCP 选项集正在更改中。

    • 当 DHCP 选项集处于 InUse 状态时,表示 DHCP 选项集更改成功。

  • ReplaceVpcDhcpOptionsSet 接口不支持针对同一个 VPC 中并发更改关联的 DHCP 选项集。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

RegionId

string

DHCP 选项集所在的地域。您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou

DhcpOptionsSetId

string

要更改的 DHCP 选项集的 ID。

dopt-o6w0df4epg9zo8isy****

VpcId

string

要更改关联的 VPC 的 ID。

vpc-dsferghthth****

ClientToken

string

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明

若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。

0c593ea1-3bea-11e9-b96b-88e9fe637760

DryRun

boolean

是否只预检此次请求,取值:

  • true:发送检查请求,不会更改 DHCP 选项集与 VPC 的关联。检查项包括 AccessKey 是否有效、RAM 用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码 DryRunOperation。

  • false(默认值):发送正常请求,通过检查后返回 2XX HTTP 状态码并直接更改 DHCP 选项集与 VPC 的关联。

false

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

示例

正常返回示例

JSON格式

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

HTTP status code

错误码

错误信息

描述

400 OperationFailed.AttachmentNotExist The current VPC is not attahced to a DHCP options set. 当前VPC没有绑定DHCP选项集实例,不允许替换。
400 IncorrectStatus.VpcDhcpOptionsSet The dhcpOptionsSet status of VPC does not support this operation. 当前VPC绑定的DHCP选项集状态处于中间态不允许操作。
400 AttrMismatching.VpcDhcpOptionsSetId The dhcpOptionsSetId does not match the VPC. DHCP选项集实例ID和VPC不匹配,请检查DHCP和VPC的对应关系是否正确。
400 TaskConflict The operation is too frequent. Please wait a moment and try again. 当前操作太频繁,请稍后重试。
400 InvalidVpcId.NotFound Specified value of VpcId is not found in our record.
400 InvalidDhcpOptionsSetId.NotFound The specified dhcpOptionsSetId does not exist. DHCP选项集实例不存在,请检查该参数是否正确。
400 IncorrectStatus.DhcpOptionsSet The DhcpOptionsSet status does not support this operation. DHCP选项集实例处于中间状态不允许操作,请等待实例状态达到稳态后在操作。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情