edit-icon download-icon

DetachKeyPair

最終更新日: Feb 26, 2019

説明

1 つ以上の Linux インスタンスから SSH キーペアを切り離します。このインターフェイスを呼び出すときは、次の点を考慮してください。

  • SSH キーペアをデタッチした後で、操作を有効にするためにインスタンス(RebootInstance)を再起動します。

  • キーペアを切り離した後は、デフォルトでユーザー名とパスワードの認証方法が使用されます。

リクエストパラメータ

名前必須かどうか説明
ActionStringはいインタフェースの名前。値:DetachKeyPair。
RegionId Stringはい SSH キーペアが属するリージョンの ID 。詳細については、DescribeRegions を呼び出して最新のリージョンリストを取得してください。
KeyPairName Stringはい SSH キーペアの名前。
InstanceIds Stringいいえインスタンス ID 。この値には、最大 50 のインスタンス ID の配列を含めることができます。 ID は [“i-xxxxxxxxx”、 “i-yyyyyyyyy”、… “i-zzzzzzzzz”] の形式で表示され、コンマ(,)で区切られています。

レスポンスパラメータ

すべてが共通のレスポンスパラメータです。詳細は、共通パラメータを参照してください。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=DetachKeyPair
  2. &RegionId=cn-qingdao
  3. &KeyPairName=test
  4. &InstanceId=xxxxxxx
  5. &<Common Request Parameters>

レスポンスの例

XML形式

  1. <DetachKeyPairResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </DetachKeyPairResponse>

JSON形式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。より多くのエラーコードについては、API のエラー・センターを参照してください。

エラーコードエラーメッセージ HTTP ステータスコード意味
MissingParameter The input parameter RegionId that is mandatory for processing this request is not supplied. 400 RegionId パラメータを指定する必要があります。または、指定されたリージョンでリソースを使用する権限がありません。
DependencyViolation.WindowsInstance The instance creating is windows, cannot use ssh key pair to logon 403 Windows インスタンスは DetachKeyPair は無効です。
InvalidKeyPairName.NotFound The specified KeyPairName does not exist in our records. 404 指定された KeyPairName は存在しません。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定された RegionId は存在しません。