調用UnassignPrivateIpAddresses從一塊彈性網卡刪除一個或多個輔助私有IP地址。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| ecs:UnassignPrivateIpAddresses | delete | *NetworkInterface acs:ecs:{#regionId}:{#accountId}:eni/{#eniId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 資源所屬地域。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| NetworkInterfaceId | string | 是 | 彈性網卡 ID。 | eni-bp67acfmxazb4ph**** |
| PrivateIpAddress | array | 否 | 一個或多個需要刪除的輔助私有 IP 地址。 | |
| string | 否 | 一個或多個需要刪除的輔助私有 IP 地址。N 的取值范圍為 1~32。 | 192.168.**.** | |
| Ipv4Prefix | array | 否 | 一個或多個需要刪除的 IPv4 前綴。 | |
| string | 否 | 一個或多個需要刪除的 IPv4 前綴。N 的取值范圍為 1~10。 | 192.168.**.**/28 |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | UnsupportedParameter | %s | 不支持參數。 |
| 400 | InvalidParameter | %s | 無效的參數。 |
| 400 | InvalidInstanceID.Malformed | %s | 參數 InstanceId 格式錯誤。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 實例當前的狀態不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 彈性網卡當前的狀態不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允許分離實例的主網卡。 |
| 400 | MissingParameter | %s | 缺失參數，請檢查參數是否完整。 |
| 400 | Forbidden.RegionId | %s | 當前地域暫時沒有提供該服務。 |
| 400 | InvalidAction | %s | 操作無效。 |
| 400 | InvalidEniId.Malformed | The specified parameter "EniId" is not valid. | - |
| 400 | InvalidParameter.Conflict | %s | 您輸入的參數無效，請檢查參數之間是否沖突。%s為變量，將根據調用API的實際情況動態返回錯誤信息。 |
| 403 | InvalidUserType.NotSupported | %s | 您當前的賬號不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云賬號不存在，或者您的 AccessKey 已經過期。 |
| 403 | Forbidden.NotSupportRAM | %s | 暫不支持RAM用戶執行該操作。 |
| 403 | Forbidden.SubUser | %s | 您的賬號沒有操作此資源的權限，請向主賬號申請相關的權限。 |
| 403 | MaxEniCountExceeded | %s | 已超過可以操作的最大彈性網卡數。 |
| 403 | EniPerInstanceLimitExceeded | %s | 實例附加的彈性網卡數量已經達到了最大限度，不能再為實例附加彈性網卡。 |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | 該操作無效。 |
| 403 | InvalidOperation.VpcMismatch | %s | 您的操作無效，請確認該操作中的 VPC 與其它參數是否匹配。 |
| 403 | SecurityGroupInstanceLimitExceed | %s | 該安全組內已有的實例數量已達到最大限制。 |
| 403 | InvalidSecurityGroupId.NotVpc | %s | 參數 SecurityGroupId 無效，該安全組的網絡類型不是專有網絡。 |
| 403 | InvalidOperation.InvalidEniType | %s | 當前彈性網卡的類型不支持此操作。 |
| 403 | InvalidVSwitchId.IpInvalid | %s | 指定的私網 IP 無效。 |
| 403 | InvalidIp.IpUnassigned | %s | 指定的 IP 未被分配。 |
| 403 | Operation.Conflict | %s | 您當前的操作與其它正在執行的操作有沖突，請稍后重試。 |
| 403 | InvalidOperation.EniServiceManaged | %s | 操作無效。 |
| 403 | InvalidPrivateIpAddress.Malformed | %s | - |
| 403 | InvalidIp.IpPrefixMaskInvalid | The ip prefixes mask %s is illegal which must be between %s and %s. | IP前綴掩碼非法，不在有效范圍內。 |
| 403 | InvalidIp.IpPrefixMaskNotSame | The ip prefixes %s are illegal which mask must be same. | IP前綴掩碼不相同。 |
| 403 | InvalidIp.IpPrefixNotStrict | The ip prefix must be strict cidr format. | IP前綴無效，不是嚴格的cidr。 |
| 403 | InvalidIp.IpPrefixIllegal | The ip prefixes %s is/are illegal. | IP前綴無效，不是cidr格式。 |
| 403 | MissingParameter | These parameters %s cannot be both empty. | - |
| 404 | InvalidEcsId.NotFound | %s | 指定的實例 ID 不存在。 |
| 404 | InvalidEniId.NotFound | %s | 指定的彈性網卡 ID 不存在。 |
| 404 | InvalidVSwitchId.NotFound | %s | 指定的交換機不存在。 |
| 404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全組 ID 不存在。 |
| 404 | InvalidInstanceId.NotFound | %s | 指定的實例不存在，請確認參數 InstanceId 是否正確。 |
| 500 | InvalidOperation.RegionNotSupportIpPrefix | The current region does not support ip prefix. | 該地域不支持分配IP前綴。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史