インスタンスから ENI を切り離します。
-
インスタンスのプライマリネットワークインターフェイスをデタッチすることはできません。
-
ENIは
In_Useステータスでなければなりません。 -
インスタンスは
RunningまたはStoppedステータスでなければなりません。
リクエストパラメータ
| パラメータ名 | 型 | 必須かどうか | 説明 |
|---|---|---|---|
| Action | String | はい | このインタフェースの名前。値:DetachNetworkInterface。 |
| RegionId | String | はい | インスタンスのリージョンのID。詳細については、DescribeRegionsを呼び出して最新のリージョンリストを取得してください。 |
| NetworkInterfaceId | String | はい | ENI ID。 |
| InstanceId | String | はい | インスタンスID。 |
レスポンスパラメータ
すべての一般的な応答パラメータの詳細については、共通パラメータを参照してください。
例
リクエスト例
https://ecs.aliyuncs.com/?Action=DetachNetworkInterface
&RegionId=cn-hangzhou
&NetworkInterfaceId=[networkInterfaceId]
&InstanceId=AY121018033933eaxxxxx
&<Common Request Parameters>
レスポンスの例
XML形式
<DetachNetworkInterfaceResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
</DetachNetworkInterfaceResponse>
JSON形式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
}
エラーコード
| エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
|---|---|---|---|
| UnsupportedParameter | The parameters is unsupported. | 400 | 指定されたパラメータは存在しません。あるいは、指定されたパラメータはサポートされていません。 |
| InvalidOperation.InvalidEcsState | The operation is not allowed in the current ECS state. | 400 | 指定されたアクションは、インスタンスの状況により失敗しました。 |
| InvalidOperation.DetachPrimaryEniNotAllowed | Detaching primary ENI from ECS instance is not allowed. | 400 | プライマリネットワークインターフェイスをインスタンスから切り離すことはできません。 |
| MissingParameter | The input parameter that is mandatory for processing this request is not supplied. | 400 | 必要なパラメータを指定する必要があります。 |
| Forbidden.SubUser | The specified action is not available for you. | 403 | RAMユーザーは、リソースへのアクセスに制限されています。 |
| Abs.InvalidAccount.NotFound | The Account is not found or ak is expired. | 403 | 指定された Alibaba Cloud アカウントは存在しません。または、AccessKey の有効期限が切れています。 |
| Forbidden.NotSupportRAM | This action does not support accessed by RAM mode. | 403 | RAMユーザーは、リソースへのアクセスに制限されています。 |
| EniPerInstanceLimitExceeded | The number of ENI exceeds the limit for the type of instance you are trying to launch. | 403 | 指定されたリージョンの ENI の最大数を超えています。 |
| InvalidOperation.InvalidEniType | The operation is not allowed in the current ENI type. | 403 | 指定されたアクションはENIのタイプのため失敗しました。 |
| InvalidEcsId.NotFound | The specified EcsId is not found. | 404 | 指定された InstanceId は存在しません。 |