|
345 | 345 | ],
|
346 | 346 | "documentation":"<p>Retrieves information about the specified finding. GetFinding and GetFindingV2 both use <code>access-analyzer:GetFinding</code> in the <code>Action</code> element of an IAM policy statement. You must have permission to perform the <code>access-analyzer:GetFinding</code> action.</p>"
|
347 | 347 | },
|
| 348 | + "GetFindingsStatistics":{ |
| 349 | + "name":"GetFindingsStatistics", |
| 350 | + "http":{ |
| 351 | + "method":"POST", |
| 352 | + "requestUri":"/analyzer/findings/statistics", |
| 353 | + "responseCode":200 |
| 354 | + }, |
| 355 | + "input":{"shape":"GetFindingsStatisticsRequest"}, |
| 356 | + "output":{"shape":"GetFindingsStatisticsResponse"}, |
| 357 | + "errors":[ |
| 358 | + {"shape":"ResourceNotFoundException"}, |
| 359 | + {"shape":"ValidationException"}, |
| 360 | + {"shape":"InternalServerException"}, |
| 361 | + {"shape":"ThrottlingException"}, |
| 362 | + {"shape":"AccessDeniedException"} |
| 363 | + ], |
| 364 | + "documentation":"<p>Retrieves a list of aggregated finding statistics for an external access or unused access analyzer.</p>" |
| 365 | + }, |
348 | 366 | "GetGeneratedPolicy":{
|
349 | 367 | "name":"GetGeneratedPolicy",
|
350 | 368 | "http":{
|
|
933 | 951 | "max":100,
|
934 | 952 | "min":0
|
935 | 953 | },
|
| 954 | + "AccountAggregations":{ |
| 955 | + "type":"list", |
| 956 | + "member":{"shape":"FindingAggregationAccountDetails"}, |
| 957 | + "max":10, |
| 958 | + "min":1 |
| 959 | + }, |
936 | 960 | "AccountIdsList":{
|
937 | 961 | "type":"list",
|
938 | 962 | "member":{"shape":"String"}
|
|
1814 | 1838 | },
|
1815 | 1839 | "documentation":"<p>Contains information about an external access finding.</p>"
|
1816 | 1840 | },
|
| 1841 | + "ExternalAccessFindingsStatistics":{ |
| 1842 | + "type":"structure", |
| 1843 | + "members":{ |
| 1844 | + "resourceTypeStatistics":{ |
| 1845 | + "shape":"ResourceTypeStatisticsMap", |
| 1846 | + "documentation":"<p>The total number of active cross-account and public findings for each resource type of the specified external access analyzer.</p>" |
| 1847 | + }, |
| 1848 | + "totalActiveFindings":{ |
| 1849 | + "shape":"Integer", |
| 1850 | + "documentation":"<p>The number of active findings for the specified external access analyzer.</p>" |
| 1851 | + }, |
| 1852 | + "totalArchivedFindings":{ |
| 1853 | + "shape":"Integer", |
| 1854 | + "documentation":"<p>The number of archived findings for the specified external access analyzer.</p>" |
| 1855 | + }, |
| 1856 | + "totalResolvedFindings":{ |
| 1857 | + "shape":"Integer", |
| 1858 | + "documentation":"<p>The number of resolved findings for the specified external access analyzer.</p>" |
| 1859 | + } |
| 1860 | + }, |
| 1861 | + "documentation":"<p>Provides aggregate statistics about the findings for the specified external access analyzer.</p>" |
| 1862 | + }, |
1817 | 1863 | "FilterCriteriaMap":{
|
1818 | 1864 | "type":"map",
|
1819 | 1865 | "key":{"shape":"String"},
|
|
1895 | 1941 | },
|
1896 | 1942 | "documentation":"<p>Contains information about a finding.</p>"
|
1897 | 1943 | },
|
| 1944 | + "FindingAggregationAccountDetails":{ |
| 1945 | + "type":"structure", |
| 1946 | + "members":{ |
| 1947 | + "account":{ |
| 1948 | + "shape":"String", |
| 1949 | + "documentation":"<p>The ID of the Amazon Web Services account for which unused access finding details are provided.</p>" |
| 1950 | + }, |
| 1951 | + "numberOfActiveFindings":{ |
| 1952 | + "shape":"Integer", |
| 1953 | + "documentation":"<p>The number of active unused access findings for the specified Amazon Web Services account.</p>" |
| 1954 | + }, |
| 1955 | + "details":{ |
| 1956 | + "shape":"FindingAggregationAccountDetailsMap", |
| 1957 | + "documentation":"<p>Provides the number of active findings for each type of unused access for the specified Amazon Web Services account.</p>" |
| 1958 | + } |
| 1959 | + }, |
| 1960 | + "documentation":"<p>Contains information about the findings for an Amazon Web Services account in an organization unused access analyzer.</p>" |
| 1961 | + }, |
| 1962 | + "FindingAggregationAccountDetailsMap":{ |
| 1963 | + "type":"map", |
| 1964 | + "key":{"shape":"String"}, |
| 1965 | + "value":{"shape":"Integer"} |
| 1966 | + }, |
1898 | 1967 | "FindingChangeType":{
|
1899 | 1968 | "type":"string",
|
1900 | 1969 | "enum":[
|
|
2145 | 2214 | "type":"list",
|
2146 | 2215 | "member":{"shape":"FindingSummaryV2"}
|
2147 | 2216 | },
|
| 2217 | + "FindingsStatistics":{ |
| 2218 | + "type":"structure", |
| 2219 | + "members":{ |
| 2220 | + "externalAccessFindingsStatistics":{ |
| 2221 | + "shape":"ExternalAccessFindingsStatistics", |
| 2222 | + "documentation":"<p>The aggregate statistics for an external access analyzer.</p>" |
| 2223 | + }, |
| 2224 | + "unusedAccessFindingsStatistics":{ |
| 2225 | + "shape":"UnusedAccessFindingsStatistics", |
| 2226 | + "documentation":"<p>The aggregate statistics for an unused access analyzer.</p>" |
| 2227 | + } |
| 2228 | + }, |
| 2229 | + "documentation":"<p>Contains information about the aggregate statistics for an external or unused access analyzer. Only one parameter can be used in a <code>FindingsStatistics</code> object.</p>", |
| 2230 | + "union":true |
| 2231 | + }, |
| 2232 | + "FindingsStatisticsList":{ |
| 2233 | + "type":"list", |
| 2234 | + "member":{"shape":"FindingsStatistics"} |
| 2235 | + }, |
2148 | 2236 | "GenerateFindingRecommendationRequest":{
|
2149 | 2237 | "type":"structure",
|
2150 | 2238 | "required":[
|
|
2552 | 2640 | }
|
2553 | 2641 | }
|
2554 | 2642 | },
|
| 2643 | + "GetFindingsStatisticsRequest":{ |
| 2644 | + "type":"structure", |
| 2645 | + "required":["analyzerArn"], |
| 2646 | + "members":{ |
| 2647 | + "analyzerArn":{ |
| 2648 | + "shape":"AnalyzerArn", |
| 2649 | + "documentation":"<p>The <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources\">ARN of the analyzer</a> used to generate the statistics.</p>" |
| 2650 | + } |
| 2651 | + } |
| 2652 | + }, |
| 2653 | + "GetFindingsStatisticsResponse":{ |
| 2654 | + "type":"structure", |
| 2655 | + "members":{ |
| 2656 | + "findingsStatistics":{ |
| 2657 | + "shape":"FindingsStatisticsList", |
| 2658 | + "documentation":"<p>A group of external access or unused access findings statistics.</p>" |
| 2659 | + }, |
| 2660 | + "lastUpdatedAt":{ |
| 2661 | + "shape":"Timestamp", |
| 2662 | + "documentation":"<p>The time at which the retrieval of the findings statistics was last updated. If the findings statistics have not been previously retrieved for the specified analyzer, this field will not be populated.</p>" |
| 2663 | + } |
| 2664 | + } |
| 2665 | + }, |
2555 | 2666 | "GetGeneratedPolicyRequest":{
|
2556 | 2667 | "type":"structure",
|
2557 | 2668 | "required":["jobId"],
|
|
3578 | 3689 | "AWS::IAM::User"
|
3579 | 3690 | ]
|
3580 | 3691 | },
|
| 3692 | + "ResourceTypeDetails":{ |
| 3693 | + "type":"structure", |
| 3694 | + "members":{ |
| 3695 | + "totalActivePublic":{ |
| 3696 | + "shape":"Integer", |
| 3697 | + "documentation":"<p>The total number of active public findings for the resource type.</p>" |
| 3698 | + }, |
| 3699 | + "totalActiveCrossAccount":{ |
| 3700 | + "shape":"Integer", |
| 3701 | + "documentation":"<p>The total number of active cross-account findings for the resource type.</p>" |
| 3702 | + } |
| 3703 | + }, |
| 3704 | + "documentation":"<p>Contains information about the total number of active cross-account and public findings for a resource type of an external access analyzer.</p>" |
| 3705 | + }, |
| 3706 | + "ResourceTypeStatisticsMap":{ |
| 3707 | + "type":"map", |
| 3708 | + "key":{"shape":"ResourceType"}, |
| 3709 | + "value":{"shape":"ResourceTypeDetails"} |
| 3710 | + }, |
3581 | 3711 | "RetiringPrincipal":{"type":"string"},
|
3582 | 3712 | "RoleArn":{
|
3583 | 3713 | "type":"string",
|
|
4044 | 4174 | },
|
4045 | 4175 | "documentation":"<p>Contains information about an unused access analyzer.</p>"
|
4046 | 4176 | },
|
| 4177 | + "UnusedAccessFindingsStatistics":{ |
| 4178 | + "type":"structure", |
| 4179 | + "members":{ |
| 4180 | + "unusedAccessTypeStatistics":{ |
| 4181 | + "shape":"UnusedAccessTypeStatisticsList", |
| 4182 | + "documentation":"<p>A list of details about the total number of findings for each type of unused access for the analyzer. </p>" |
| 4183 | + }, |
| 4184 | + "topAccounts":{ |
| 4185 | + "shape":"AccountAggregations", |
| 4186 | + "documentation":"<p>A list of one to ten Amazon Web Services accounts that have the most active findings for the unused access analyzer.</p>" |
| 4187 | + }, |
| 4188 | + "totalActiveFindings":{ |
| 4189 | + "shape":"Integer", |
| 4190 | + "documentation":"<p>The total number of active findings for the unused access analyzer.</p>" |
| 4191 | + }, |
| 4192 | + "totalArchivedFindings":{ |
| 4193 | + "shape":"Integer", |
| 4194 | + "documentation":"<p>The total number of archived findings for the unused access analyzer.</p>" |
| 4195 | + }, |
| 4196 | + "totalResolvedFindings":{ |
| 4197 | + "shape":"Integer", |
| 4198 | + "documentation":"<p>The total number of resolved findings for the unused access analyzer.</p>" |
| 4199 | + } |
| 4200 | + }, |
| 4201 | + "documentation":"<p>Provides aggregate statistics about the findings for the specified unused access analyzer.</p>" |
| 4202 | + }, |
| 4203 | + "UnusedAccessTypeStatistics":{ |
| 4204 | + "type":"structure", |
| 4205 | + "members":{ |
| 4206 | + "unusedAccessType":{ |
| 4207 | + "shape":"String", |
| 4208 | + "documentation":"<p>The type of unused access.</p>" |
| 4209 | + }, |
| 4210 | + "total":{ |
| 4211 | + "shape":"Integer", |
| 4212 | + "documentation":"<p>The total number of findings for the specified unused access type.</p>" |
| 4213 | + } |
| 4214 | + }, |
| 4215 | + "documentation":"<p>Contains information about the total number of findings for a type of unused access.</p>" |
| 4216 | + }, |
| 4217 | + "UnusedAccessTypeStatisticsList":{ |
| 4218 | + "type":"list", |
| 4219 | + "member":{"shape":"UnusedAccessTypeStatistics"} |
| 4220 | + }, |
4047 | 4221 | "UnusedAction":{
|
4048 | 4222 | "type":"structure",
|
4049 | 4223 | "required":["action"],
|
|
0 commit comments