As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
GetFindingV2
Recupera informações sobre a descoberta especificada. GetFinding e GetFinding V2 são usadas access-analyzer:GetFinding no Action elemento de uma declaração de política do IAM. Você deve ter permissão para realizar a access-analyzer:GetFinding ação.
Sintaxe da Solicitação
GET /findingv2/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- analyzerArn
-
O ARN do analisador que gerou a descoberta.
Padrão:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Exigido: Sim
- id
-
O ID da descoberta a ser recuperada.
Obrigatório: sim
- maxResults
-
O número máximo de resultados a serem retornados na resposta.
- nextToken
-
Um token usado para paginação dos resultados retornados.
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da resposta
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"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- analyzedAt
-
O momento em que a política baseada em recursos ou a entidade do IAM que gerou a descoberta foi analisada.
Tipo: carimbo de data/hora
- createdAt
-
A hora em que a descoberta foi criada.
Tipo: carimbo de data/hora
- error
-
Um erro.
Tipo: string
- findingDetails
-
Uma mensagem localizada que explica a descoberta e fornece orientação sobre como lidar com ela.
Tipo: matriz de objetos FindingDetails
- findingType
-
O tipo da descoberta do . Para analisadores de acesso externo, o tipo é.
ExternalAccessPara analisadores de acesso não utilizados, o tipo pode serUnusedIAMRole,UnusedIAMUserAccessKey,UnusedIAMUserPasswordou.UnusedPermissionTipo: string
Valores Válidos:
ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission - id
-
O ID da descoberta a ser recuperada.
Tipo: string
- nextToken
-
Um token usado para paginação dos resultados retornados.
Tipo: string
- resource
-
O recurso que gerou a descoberta.
Tipo: string
- resourceOwnerAccount
-
O Conta da AWS ID que possui o recurso.
Tipo: string
- resourceType
-
O tipo do recurso identificado na descoberta.
Tipo: string
Valores Válidos:
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
-
O status da descoberta.
Tipo: string
Valores Válidos:
ACTIVE | ARCHIVED | RESOLVED - updatedAt
-
A hora em que a descoberta foi atualizada.
Tipo: carimbo de data/hora
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulte Erros comuns.
- AccessDeniedException
-
Você não tem acesso suficiente para executar esta ação.
Código de status HTTP: 403
- InternalServerException
-
Erro interno do servidor.
Código de status HTTP: 500
- ResourceNotFoundException
-
Não foi possível encontrar o recurso especificado.
Código de status HTTP: 404
- ThrottlingException
-
Erro de limite de limitação excedido.
Código de status HTTP: 429
- ValidationException
-
Erro de exceção de validação.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
