GetFindingV2 - IAM Access Analyzer
请求语法URI请求参数请求正文响应语法响应元素错误另请参阅

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

GetFindingV2

检索有关指定查找结果的信息。 GetFinding 和 GetFinding V2 都在IAM政策声明的Action元素access-analyzer:GetFinding中使用。您必须拥有执行该access-analyzer:GetFinding操作的权限。

请求语法

GET /findingv2/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1

URI请求参数

该请求使用以下URI参数。

analyzerArn

生成发现结果ARN的分析器的。

模式：[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

必需：是

id

要检索的发现的 ID。

必需：是

maxResults

响应中返回的最大结果数。

nextToken

用于对返回的结果进行分页的标记。

请求正文

该请求没有请求正文。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "analyzedAt": "string",
   "createdAt": "string",
   "error": "string",
   "findingDetails": [ 
      { ... }
   ],
   "findingType": "string",
   "id": "string",
   "nextToken": "string",
   "resource": "string",
   "resourceOwnerAccount": "string",
   "resourceType": "string",
   "status": "string",
   "updatedAt": "string"
}

响应元素

如果操作成功，服务将发回 HTTP 200 响应。

以下数据由服务以JSON格式返回。

analyzedAt

对产生调查结果的基于资源的策略或IAM实体进行分析的时间。

类型：时间戳

createdAt

发现的创建时间。

类型：时间戳

error

一个错误。

类型：字符串

findingDetails

本地化消息，用于解释调查结果并就如何解决问题提供指导。

类型：FindingDetails 对象数组

findingType

结果的类型。对于外部访问分析器，类型为ExternalAccess。对于未使用的访问分析器，类型可以是UnusedIAMRole、UnusedIAMUserAccessKeyUnusedIAMUserPassword、或UnusedPermission。

类型：字符串

有效值：ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission

id

要检索的发现的 ID。

类型：字符串

nextToken

用于对返回的结果进行分页的标记。

类型：字符串

resource

生成调查结果的资源。

类型：字符串

resourceOwnerAccount

拥有资源的 AWS 账户 ID。

类型：字符串

resourceType

调查结果中确定的资源类型。

类型：字符串

有效值：AWS::S3::Bucket | AWS::IAM::Role | AWS::SQS::Queue | AWS::Lambda::Function | AWS::Lambda::LayerVersion | AWS::KMS::Key | AWS::SecretsManager::Secret | AWS::EFS::FileSystem | AWS::EC2::Snapshot | AWS::ECR::Repository | AWS::RDS::DBSnapshot | AWS::RDS::DBClusterSnapshot | AWS::SNS::Topic | AWS::S3Express::DirectoryBucket | AWS::DynamoDB::Table | AWS::DynamoDB::Stream | AWS::IAM::User

status

调查发现的状态。

类型：字符串

有效值：ACTIVE | ARCHIVED | RESOLVED

updatedAt

调查结果的更新时间。

类型：时间戳

错误

有关所有操作的常见错误信息，请参阅 常见错误。

AccessDeniedException

您没有足够的访问权限，无法执行该操作。

HTTP状态码：403

InternalServerException

内部服务器错误。

HTTP状态码：500

ResourceNotFoundException

找不到指定资源。

HTTP状态码：404

ThrottlingException

超过限制限制错误。

HTTP状态码：429

ValidationException

验证异常错误。

HTTP状态码：400

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：