調(diào)用AttachNetworkInterface接口，并可以指定NetworkInterfaceId、InstanceId、NetworkCardIndex等參數(shù)，附加一個彈性網(wǎng)卡（ENI）到一臺專有網(wǎng)絡(luò)VPC類型ECS實例上。
接口說明
調(diào)用該接口時，請注意：
-
彈性網(wǎng)卡必須處于可用（
Available）狀態(tài)，一個彈性網(wǎng)卡只能同時附加到一臺相同可用區(qū)且相同專有網(wǎng)絡(luò)的實例上。 -
實例需處于運行中（Running）或者已停止（Stopped）狀態(tài)，部分實例規(guī)格的實例在附加彈性網(wǎng)卡時必須為已停止（Stopped）狀態(tài)，更多信息，請參見附加彈性網(wǎng)卡中的需要停止實例的 ECS 實例規(guī)格章節(jié)。
說明 如果實例最后一次啟動時間在 2018 年 4 月 1 日之前（包括但不限于啟動新購的實例、重啟、重開機），您必須提前調(diào)用 RebootInstance 重啟一直保持運行中狀態(tài)的實例，否則無法附加彈性網(wǎng)卡。 -
一臺實例可以同時附加多個彈性網(wǎng)卡，更多信息，請參見彈性網(wǎng)卡概述。
-
彈性網(wǎng)卡所在的交換機必須與實例所在交換機屬于同一可用區(qū)且同一專有網(wǎng)絡(luò) VPC。
-
該接口為異步接口，調(diào)用成功后，您可以通過查詢彈性網(wǎng)卡狀態(tài)或監(jiān)聽網(wǎng)卡操作事件的方式來感知操作結(jié)果。 彈性網(wǎng)卡狀態(tài)機如下圖所示：
- Attaching 說明附加彈性網(wǎng)卡請求發(fā)送成功，彈性網(wǎng)卡正在附加到 ECS 實例中。
- InUse 說明彈性網(wǎng)卡已附加到 ECS 實例。
- Available 說明彈性網(wǎng)卡附加到 ECS 實例失敗。
調(diào)用示例詳情參見附加彈性網(wǎng)卡。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| ecs:AttachNetworkInterface | update | *NetworkInterface acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}*Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 實例所在地域的 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| NetworkInterfaceId | string | 是 | 彈性網(wǎng)卡 ID。 | eni-bp17pdijfczax1huji**** |
| InstanceId | string | 是 | 實例 ID。 | i-bp16qstyvxj9gpqw**** |
| TrunkNetworkInstanceId | string | 否 | 中繼網(wǎng)卡 ID。 說明
該參數(shù)暫未上線，不支持使用。
| eni-f8zapqwj1v1j4ia3**** |
| WaitForNetworkConfigurationReady | boolean | 否 | 說明
該參數(shù)已廢棄。
| null |
| NetworkCardIndex | integer | 否 | 網(wǎng)卡指定的物理網(wǎng)卡索引。 說明
NetworkCardIndex 取值與實例規(guī)格族有關(guān)。如果實例規(guī)格不支持 NetworkCard 則不能指定；如果支持，取值請參見實例規(guī)格族。
| 0 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | MissingParameter | %s | 缺失參數(shù)，請檢查參數(shù)是否完整。 |
| 400 | UnsupportedParameter | %s | 不支持參數(shù)。 |
| 400 | InvalidParameter | %s | 無效的參數(shù)。 |
| 400 | InvalidInstanceID.Malformed | %s | 參數(shù) InstanceId 格式錯誤。 |
| 400 | InvalidOperation.InvalidRegion | %s | 指定的參數(shù) RegionId 無效。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 實例當前的狀態(tài)不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 彈性網(wǎng)卡當前的狀態(tài)不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允許分離實例的主網(wǎng)卡。 |
| 400 | Forbidden.RegionId | %s | 當前地域暫時沒有提供該服務(wù)。 |
| 400 | InvalidOperation.InvalidGeneration | %s | 該操作無效。 |
| 400 | InvalidParams.EniId | %s | 指定的參數(shù) EniId 無效。 |
| 400 | InvalidOperation.UserNotSupportNetworkCard | User not support network card. | - |
| 400 | InvalidOperation.ConnectionTrackingConfigNotSupportMemberEni | Member eni not support ConnectionTrackingConfiguration. | 成員網(wǎng)卡不支持指定網(wǎng)絡(luò)連接配置 |
| 400 | InvalidOperation.InvalidEcsState | %s. | 實例當前的狀態(tài)不支持此操作。 |
| 400 | InvalidParameter.NetworkCardIndexInvalid | The network card index is invalid or the current ECS/ENI type does not support the value. | 物理網(wǎng)卡屬性不符合網(wǎng)卡或者實例類型限制 |
| 403 | InvalidUserType.NotSupported | %s | 您當前的賬號不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云賬號不存在，或者您的 AccessKey 已經(jīng)過期。 |
| 403 | Forbidden.NotSupportRAM | %s | 暫不支持RAM用戶執(zhí)行該操作。 |
| 403 | Forbidden.SubUser | %s | 您的賬號沒有操作此資源的權(quán)限，請向主賬號申請相關(guān)的權(quán)限。 |
| 403 | MaxEniCountExceeded | %s | 已超過可以操作的最大彈性網(wǎng)卡數(shù)。 |
| 403 | EniPerInstanceLimitExceeded | %s | 實例附加的彈性網(wǎng)卡數(shù)量已經(jīng)達到了最大限度，不能再為實例附加彈性網(wǎng)卡。 |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | 該操作無效。 |
| 403 | InvalidOperation.VpcMismatch | %s | 您的操作無效，請確認該操作中的 VPC 與其它參數(shù)是否匹配。 |
| 403 | SecurityGroupInstanceLimitExceed | %s | 該安全組內(nèi)已有的實例數(shù)量已達到最大限制。 |
| 403 | InvalidSecurityGroupId.NotVpc | %s | 參數(shù) SecurityGroupId 無效，該安全組的網(wǎng)絡(luò)類型不是專有網(wǎng)絡(luò)。 |
| 403 | InvalidOperation.InvalidEniType | %s | 當前彈性網(wǎng)卡的類型不支持此操作。 |
| 403 | InvalidInstanceId.NotFound | %s | 指定的實例不存在，請確認參數(shù) InstanceId 是否正確。 |
| 403 | InvalidEni.NotSameVpc | %s | 指定的資源和指定的ENI不屬于同一個VPC。具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.Ipv4CountExceeded | %s | IPv4 數(shù)量達到上限，導(dǎo)致該操作無效。 |
| 403 | InvalidOperation.EniServiceManaged | %s | 操作無效。 |
| 403 | InvalidOperation.MultiGroupType | The specified instance can't join different types of security group. | 指定的實例無法加入不同類型的安全組 |
| 403 | InvalidOperation.NotSupportEnterpriseGroup | The specified instance type doesn't support enterprise level security group. | - |
| 403 | InvalidOperation.EniCountExceeded | The maximum number of eni in a enterprise level security group is exceeded. | - |
| 403 | InvalidOperation.EipBindModel | %s | - |
| 403 | InvalidOperation.Ipv6NotSupport | %s | IPv6不支持當前操作。 |
| 403 | InvalidOperation.HotPlugNotSupport | %s | 指定的資源處于運行狀態(tài)，不支持本次操作，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidInstance.NetworkType | %s | - |
| 403 | InvalidOperation.InvalidTrunkEniStatus | %s | 指定的中繼模式的ENI狀態(tài)不允許執(zhí)行本次操作，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.TrunkingIsNotAllowed | %s | - |
| 403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | 不支持本次操作。具體信息請參見錯誤信息%s占位符的實際返回值。 |
| 403 | InvalidOperation.EniTypeNotSupportTrunking | %s | ENI的類型不支持中繼模式的相關(guān)操作，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.EniTrunkDeviceFull | %s | - |
| 403 | InvalidParameter.EniNotBelongTrunk | %s | 指定的ENI不屬于中繼模式的ENI，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.EniTypeNotSupportAttachToTrunk | %s | - |
| 403 | InvalidParameter.EniNotBelongEcs | %s | 指定的ENI不屬于指定的ECS實例，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。您可以調(diào)用DescribeInstances查看指定ECS實例已附加的ENI ID。 |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | 彈性網(wǎng)卡隊列數(shù)有誤，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | 彈性網(wǎng)卡隊列數(shù)超過上限，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | 彈性網(wǎng)卡隊列總數(shù)超過上限，具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.HighPerformanceTrafficModeNotSupportTrunkEni | %s | - |
| 403 | InvalidOperation.HighPerformanceTrafficModeNotSupportMemberEni | %s | - |
| 403 | InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode | %s | - |
| 403 | InvalidOperation.EniTrafficModeNotSupportIpv6 | %s | - |
| 403 | InvalidOperation.MaxEniQueuePairNumberExceed | %s | - |
| 403 | InvalidParameter.InvalidQueuePairNumber | %s | - |
| 403 | InvalidOperation.EniQueuePairNumberOverflow | %s | - |
| 403 | InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded | %s | - |
| 403 | InvalidEni.NotSameVpc | %s. | 指定的資源和指定的ENI不屬于同一個VPC。具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
| 403 | InvalidOperation.Ipv6CountExceeded | %s. | IPv6 數(shù)量達到上限，導(dǎo)致該操作無效。 |
| 404 | InvalidEcsId.NotFound | %s | 指定的實例 ID 不存在。 |
| 404 | InvalidEniId.NotFound | %s | 指定的彈性網(wǎng)卡 ID 不存在。 |
| 404 | InvalidVSwitchId.NotFound | %s | 指定的交換機不存在。 |
| 404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全組 ID 不存在。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內(nèi)部錯誤，請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-09-12 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-05-08 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-05-07 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-01-04 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |