：阿里雲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中會包含一個欄位AccessDeniedDetail，用來描述許可權失敗的詳細原因，可以通過getAccessDeniedDetail()方法擷取。以Java語言為例：

V1.0 Java SDK樣本

// 產生的 SDK 的 Request
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());
}

V2.0 Java SDK樣本

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欄位，通過該欄位可以獲得許可權拒絕的詳細資料，可通過下面任意一個途徑進行解析：

• 通過調用“存取控制”產品中的DecodeDiagnosticMessage介面進行解析。

• 在OpenAPI Troubleshoot輸入請求RequestId即可獲得許可權報錯和解決方案。

• 通過控制台許可權診斷頁面進行診斷。

更多資訊，請參見如何排查無許可權的訪問錯誤。

許可權配置建議

必要操作許可權

如果確認此許可權為必要操作許可權，請聯絡您的主帳號或許可權管理員，對上述診斷結果涉及的許可權（AuthAction）進行為RAM使用者授權或者為RAM角色授權。

相容性處理

如果需要對報錯請求進行捕獲識別，請try...catch對應的異常，判斷錯誤碼是否為Forbidden.RAM，此錯誤碼代表子帳號缺少RAM許可權。