:Alibaba Cloud ECS クエリ API 操作の認証メカニズムの変更に関するお知らせ

アップグレード前後の比較

この例では、DescribeInstances 操作が使用されます。ecs:DescribeInstances 権限なしで操作を呼び出すと、アップグレード前と後で次の応答が返されます。

{
  "RequestId": "ABCD-1234-1234-ABCD",
  "Instances": {
    "Instance": []
  },
  "NextToken": "",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 0
}

{
  "RequestId": "ABCD-1234-1234-ABCD",
  "HostId": "ecs.cn-hangzhou.aliyuncs.com",
  "Code": "Forbidden.RAM",
  "Message": "User not authorized to operate on the specified resource, or this API doesn't support RAM.",
  "Recommend": "https://api.aliyun.com/troubleshoot?q=Forbidden.RAM&product=Ecs&requestId=ABCD-1234-1234-ABCD",
  "AccessDeniedDetail": {
    "AuthAction": "ecs:DescribeInstances",
    ...
  }
}

影響を受ける API 操作

SDK 呼び出しの適応

コードで権限エラー (Exception) をキャプチャし、それに応じて処理します。Exception 要素には、権限エラーの詳細な理由を説明する AccessDeniedDetail フィールドが含まれています。getAccessDeniedDetail() 関数を使用してフィールドを取得できます。Java の例:

SDK V1.0 for Java の例:

// SDK リクエストを生成します。
DescribeXXXRequest request = new DescribeXXXRequest();
try {
    DescribeXXXResponse response = client.getAcsResponse(request);
} catch (ServerException e) {
    // エラーコードを表示します。
    System.out.println(e.getErrCode());
} catch (ClientException e) {
    // エラーコードを表示します。権限エラーの場合、Forbidden.RAM が返されます。
    System.out.println(e.getErrCode());
    // 権限エラーの詳細な理由を取得します。
    System.out.println(e.getAccessDeniedDetail());
}

SDK V2.0 for Java の例:

DescribeXXXRequest request = new DescribeXXXRequest();
try {
    client.describeXXX(request);
} catch (TeaException e) {
    // エラーコードを表示します。権限エラーの場合、Forbidden.RAM が返されます。
    System.out.println(e.getErrCode());
    // 権限エラーの詳細な理由を取得します。
    System.out.println(e.getAccessDeniedDetail());
}

次の表に、他の言語とバージョンの SDK 呼び出しの適応について説明します。

権限の診断とトラブルシューティング

権限エラーが発生すると、応答には権限拒否に関する詳細情報を提供する AccessDeniedDetail フィールドが含まれます。次のいずれかの方法でこの情報を解析できます。

• RAM の DecodeDiagnosticMessage 操作を呼び出します。

• OpenAPI トラブルシューティング ページでリクエスト ID (RequestId) を入力して、権限エラーの詳細とソリューションを取得します。

• RAM コンソールの トラブルシューティング ページを使用します。

詳細については、「アクセス拒否エラーのトラブルシューティング方法」をご参照ください。

権限設定の提案

必要な操作権限の付与

操作に AuthAction 権限が必要であることを確認した場合、診断結果に基づいて、Alibaba Cloud アカウントのオーナーまたは権限管理者に連絡して、RAM ユーザーに権限を付与するか、RAM ロールに権限を付与してください。

互換性の処理

エラー応答をキャプチャして識別するには、try...catch を使用して対応する例外をキャッチし、エラーコードが Forbidden.RAM であるかどうかを確認します。これは、RAM ユーザーに必要な RAM 権限がないことを示します。