AWS SecurityHub 2018-10-26
- Client: Aws\SecurityHub\SecurityHubClient
- Service ID: securityhub
- Version: 2018-10-26
This page describes the parameters and results for the operations of the AWS SecurityHub (2018-10-26), and shows how to use the Aws\SecurityHub\SecurityHubClient object to call the described operations. This documentation is specific to the 2018-10-26 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName'), where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */).
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */).
- AcceptAdministratorInvitation ( array $params = [] )
Accepts the invitation to be a member account and be monitored by the Security Hub administrator account that the invitation was sent from.
- AcceptInvitation ( array $params = [] )
This method is deprecated.
- BatchDisableStandards ( array $params = [] )
Disables the standards specified by the provided StandardsSubscriptionArns.
- BatchEnableStandards ( array $params = [] )
Enables the standards specified by the provided StandardsArn.
- BatchImportFindings ( array $params = [] )
Imports security findings generated from an integrated product into Security Hub.
- BatchUpdateFindings ( array $params = [] )
Used by Security Hub customers to update information about their investigation into a finding.
- CreateActionTarget ( array $params = [] )
Creates a custom action target in Security Hub.
- CreateInsight ( array $params = [] )
Creates a custom insight in Security Hub.
- CreateMembers ( array $params = [] )
Creates a member association in Security Hub between the specified accounts and the account used to make the request, which is the administrator account.
- DeclineInvitations ( array $params = [] )
Declines invitations to become a member account.
- DeleteActionTarget ( array $params = [] )
Deletes a custom action target from Security Hub.
- DeleteInsight ( array $params = [] )
Deletes the insight specified by the InsightArn.
- DeleteInvitations ( array $params = [] )
Deletes invitations received by the Amazon Web Services account to become a member account.
- DeleteMembers ( array $params = [] )
Deletes the specified member accounts from Security Hub.
- DescribeActionTargets ( array $params = [] )
Returns a list of the custom action targets in Security Hub in your account.
- DescribeHub ( array $params = [] )
Returns details about the Hub resource in your account, including the HubArn and the time when you enabled Security Hub.
- DescribeOrganizationConfiguration ( array $params = [] )
Returns information about the Organizations configuration for Security Hub.
- DescribeProducts ( array $params = [] )
Returns information about product integrations in Security Hub.
- DescribeStandards ( array $params = [] )
Returns a list of the available standards in Security Hub.
- DescribeStandardsControls ( array $params = [] )
Returns a list of security standards controls.
- DisableImportFindingsForProduct ( array $params = [] )
Disables the integration of the specified product with Security Hub.
- DisableOrganizationAdminAccount ( array $params = [] )
Disables a Security Hub administrator account.
- DisableSecurityHub ( array $params = [] )
Disables Security Hub in your account only in the current Region.
- DisassociateFromAdministratorAccount ( array $params = [] )
Disassociates the current Security Hub member account from the associated administrator account.
- DisassociateFromMasterAccount ( array $params = [] )
This method is deprecated.
- DisassociateMembers ( array $params = [] )
Disassociates the specified member accounts from the associated administrator account.
- EnableImportFindingsForProduct ( array $params = [] )
Enables the integration of a partner product with Security Hub.
- EnableOrganizationAdminAccount ( array $params = [] )
Designates the Security Hub administrator account for an organization.
- EnableSecurityHub ( array $params = [] )
Enables Security Hub for your account in the current Region or the Region you specify in the request.
- GetAdministratorAccount ( array $params = [] )
Provides the details for the Security Hub administrator account for the current member account.
- GetEnabledStandards ( array $params = [] )
Returns a list of the standards that are currently enabled.
- GetFindings ( array $params = [] )
Returns a list of findings that match the specified criteria.
- GetInsightResults ( array $params = [] )
Lists the results of the Security Hub insight specified by the insight ARN.
- GetInsights ( array $params = [] )
Lists and describes insights for the specified insight ARNs.
- GetInvitationsCount ( array $params = [] )
Returns the count of all Security Hub membership invitations that were sent to the current member account, not including the currently accepted invitation.
- GetMasterAccount ( array $params = [] )
This method is deprecated.
- GetMembers ( array $params = [] )
Returns the details for the Security Hub member accounts for the specified account IDs.
- InviteMembers ( array $params = [] )
Invites other Amazon Web Services accounts to become member accounts for the Security Hub administrator account that the invitation is sent from.
- ListEnabledProductsForImport ( array $params = [] )
Lists all findings-generating solutions (products) that you are subscribed to receive findings from in Security Hub.
- ListInvitations ( array $params = [] )
Lists all Security Hub membership invitations that were sent to the current Amazon Web Services account.
- ListMembers ( array $params = [] )
Lists details about all member accounts for the current Security Hub administrator account.
- ListOrganizationAdminAccounts ( array $params = [] )
Lists the Security Hub administrator accounts.
- ListTagsForResource ( array $params = [] )
Returns a list of tags associated with a resource.
- TagResource ( array $params = [] )
Adds one or more tags to a resource.
- UntagResource ( array $params = [] )
Removes one or more tags from a resource.
- UpdateActionTarget ( array $params = [] )
Updates the name and description of a custom action target in Security Hub.
- UpdateFindings ( array $params = [] )
UpdateFindings is deprecated.
- UpdateInsight ( array $params = [] )
Updates the Security Hub insight identified by the specified insight ARN.
- UpdateOrganizationConfiguration ( array $params = [] )
Used to update the configuration related to Organizations.
- UpdateSecurityHubConfiguration ( array $params = [] )
Updates configuration options for Security Hub.
- UpdateStandardsControl ( array $params = [] )
Used to control whether an individual security standard control is enabled or disabled.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Operations
AcceptAdministratorInvitation
$result = $client->acceptAdministratorInvitation([/* ... */]); $promise = $client->acceptAdministratorInvitationAsync([/* ... */]);
Accepts the invitation to be a member account and be monitored by the Security Hub administrator account that the invitation was sent from.
This operation is only used by member accounts that are not added through Organizations.
When the member account accepts the invitation, permission is granted to the administrator account to view findings generated in the member account.
Parameter Syntax
$result = $client->acceptAdministratorInvitation([
'AdministratorId' => '<string>', // REQUIRED
'InvitationId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
AcceptInvitation
$result = $client->acceptInvitation([/* ... */]); $promise = $client->acceptInvitationAsync([/* ... */]);
This method is deprecated. Instead, use AcceptAdministratorInvitation.
The Security Hub console continues to use AcceptInvitation. It will eventually change to use AcceptAdministratorInvitation. Any IAM policies that specifically control access to this function must continue to use AcceptInvitation. You should also add AcceptAdministratorInvitation to your policies to ensure that the correct permissions are in place after the console begins to use AcceptAdministratorInvitation.
Accepts the invitation to be a member account and be monitored by the Security Hub administrator account that the invitation was sent from.
This operation is only used by member accounts that are not added through Organizations.
When the member account accepts the invitation, permission is granted to the administrator account to view findings generated in the member account.
Parameter Syntax
$result = $client->acceptInvitation([
'InvitationId' => '<string>', // REQUIRED
'MasterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
BatchDisableStandards
$result = $client->batchDisableStandards([/* ... */]); $promise = $client->batchDisableStandardsAsync([/* ... */]);
Disables the standards specified by the provided StandardsSubscriptionArns.
For more information, see Security Standards section of the Security Hub User Guide.
Parameter Syntax
$result = $client->batchDisableStandards([
'StandardsSubscriptionArns' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'StandardsSubscriptions' => [
[
'StandardsArn' => '<string>',
'StandardsInput' => ['<string>', ...],
'StandardsStatus' => 'PENDING|READY|FAILED|DELETING|INCOMPLETE',
'StandardsSubscriptionArn' => '<string>',
],
// ...
],
]
Result Details
Members
- StandardsSubscriptions
-
- Type: Array of StandardsSubscription structures
The details of the standards subscriptions that were disabled.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
BatchEnableStandards
$result = $client->batchEnableStandards([/* ... */]); $promise = $client->batchEnableStandardsAsync([/* ... */]);
Enables the standards specified by the provided StandardsArn. To obtain the ARN for a standard, use the DescribeStandards operation.
For more information, see the Security Standards section of the Security Hub User Guide.
Parameter Syntax
$result = $client->batchEnableStandards([
'StandardsSubscriptionRequests' => [ // REQUIRED
[
'StandardsArn' => '<string>', // REQUIRED
'StandardsInput' => ['<string>', ...],
],
// ...
],
]);
Parameter Details
Members
- StandardsSubscriptionRequests
-
- Required: Yes
- Type: Array of StandardsSubscriptionRequest structures
The list of standards checks to enable.
Result Syntax
[
'StandardsSubscriptions' => [
[
'StandardsArn' => '<string>',
'StandardsInput' => ['<string>', ...],
'StandardsStatus' => 'PENDING|READY|FAILED|DELETING|INCOMPLETE',
'StandardsSubscriptionArn' => '<string>',
],
// ...
],
]
Result Details
Members
- StandardsSubscriptions
-
- Type: Array of StandardsSubscription structures
The details of the standards subscriptions that were enabled.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
BatchImportFindings
$result = $client->batchImportFindings([/* ... */]); $promise = $client->batchImportFindingsAsync([/* ... */]);
Imports security findings generated from an integrated product into Security Hub. This action is requested by the integrated product to import its findings into Security Hub.
The maximum allowed size for a finding is 240 Kb. An error is returned for any finding larger than 240 Kb.
After a finding is created, BatchImportFindings cannot be used to update the following finding fields and objects, which Security Hub customers use to manage their investigation workflow.
-
Note -
UserDefinedFields -
VerificationState -
Workflow
Finding providers also should not use BatchImportFindings to update the following attributes.
-
Confidence -
Criticality -
RelatedFindings -
Severity -
Types
Instead, finding providers use FindingProviderFields to provide values for these attributes.
Parameter Syntax
$result = $client->batchImportFindings([
'Findings' => [ // REQUIRED
[
'Action' => [
'ActionType' => '<string>',
'AwsApiCallAction' => [
'AffectedResources' => ['<string>', ...],
'Api' => '<string>',
'CallerType' => '<string>',
'DomainDetails' => [
'Domain' => '<string>',
],
'FirstSeen' => '<string>',
'LastSeen' => '<string>',
'RemoteIpDetails' => [
'City' => [
'CityName' => '<string>',
],
'Country' => [
'CountryCode' => '<string>',
'CountryName' => '<string>',
],
'GeoLocation' => [
'Lat' => <float>,
'Lon' => <float>,
],
'IpAddressV4' => '<string>',
'Organization' => [
'Asn' => <integer>,
'AsnOrg' => '<string>',
'Isp' => '<string>',
'Org' => '<string>',
],
],
'ServiceName' => '<string>',
],
'DnsRequestAction' => [
'Blocked' => true || false,
'Domain' => '<string>',
'Protocol' => '<string>',
],
'NetworkConnectionAction' => [
'Blocked' => true || false,
'ConnectionDirection' => '<string>',
'LocalPortDetails' => [
'Port' => <integer>,
'PortName' => '<string>',
],
'Protocol' => '<string>',
'RemoteIpDetails' => [
'City' => [
'CityName' => '<string>',
],
'Country' => [
'CountryCode' => '<string>',
'CountryName' => '<string>',
],
'GeoLocation' => [
'Lat' => <float>,
'Lon' => <float>,
],
'IpAddressV4' => '<string>',
'Organization' => [
'Asn' => <integer>,
'AsnOrg' => '<string>',
'Isp' => '<string>',
'Org' => '<string>',
],
],
'RemotePortDetails' => [
'Port' => <integer>,
'PortName' => '<string>',
],
],
'PortProbeAction' => [
'Blocked' => true || false,
'PortProbeDetails' => [
[
'LocalIpDetails' => [
'IpAddressV4' => '<string>',
],
'LocalPortDetails' => [
'Port' => <integer>,
'PortName' => '<string>',
],
'RemoteIpDetails' => [
'City' => [
'CityName' => '<string>',
],
'Country' => [
'CountryCode' => '<string>',
'CountryName' => '<string>',
],
'GeoLocation' => [
'Lat' => <float>,
'Lon' => <float>,
],
'IpAddressV4' => '<string>',
'Organization' => [
'Asn' => <integer>,
'AsnOrg' => '<string>',
'Isp' => '<string>',
'Org' => '<string>',
],
],
],
// ...
],
],
],
'AwsAccountId' => '<string>', // REQUIRED
'CompanyName' => '<string>',
'Compliance' => [
'RelatedRequirements' => ['<string>', ...],
'Status' => 'PASSED|WARNING|FAILED|NOT_AVAILABLE',
'StatusReasons' => [
[
'Description' => '<string>',
'ReasonCode' => '<string>', // REQUIRED
],
// ...
],
],
'Confidence' => <integer>,
'CreatedAt' => '<string>', // REQUIRED
'Criticality' => <integer>,
'Description' => '<string>', // REQUIRED
'FindingProviderFields' => [
'Confidence' => <integer>,
'Criticality' => <integer>,
'RelatedFindings' => [
[
'Id' => '<string>', // REQUIRED
'ProductArn' => '<string>', // REQUIRED
],
// ...
],
'Severity' => [
'Label' => 'INFORMATIONAL|LOW|MEDIUM|HIGH|CRITICAL',
'Original' => '<string>',
],
'Types' => ['<string>', ...],
],
'FirstObservedAt' => '<string>',
'GeneratorId' => '<string>', // REQUIRED
'Id' => '<string>', // REQUIRED
'LastObservedAt' => '<string>',
'Malware' => [
[
'Name' => '<string>', // REQUIRED
'Path' => '<string>',
'State' => 'OBSERVED|REMOVAL_FAILED|REMOVED',
'Type' => 'ADWARE|BLENDED_THREAT|BOTNET_AGENT|COIN_MINER|EXPLOIT_KIT|KEYLOGGER|MACRO|POTENTIALLY_UNWANTED|SPYWARE|RANSOMWARE|REMOTE_ACCESS|ROOTKIT|TROJAN|VIRUS|WORM',
],
// ...
],
'Network' => [
'DestinationDomain' => '<string>',
'DestinationIpV4' => '<string>',
'DestinationIpV6' => '<string>',
'DestinationPort' => <integer>,
'Direction' => 'IN|OUT',
'OpenPortRange' => [
'Begin' => <integer>,
'End' => <integer>,
],
'Protocol' => '<string>',
'SourceDomain' => '<string>',
'SourceIpV4' => '<string>',
'SourceIpV6' => '<string>',
'SourceMac' => '<string>',
'SourcePort' => <integer>,
],
'NetworkPath' => [
[
'ComponentId' => '<string>',
'ComponentType' => '<string>',
'Egress' => [
'Destination' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
'Protocol' => '<string>',
'Source' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
],
'Ingress' => [
'Destination' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
'Protocol' => '<string>',
'Source' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
],
],
// ...
],
'Note' => [
'Text' => '<string>', // REQUIRED
'UpdatedAt' => '<string>', // REQUIRED
'UpdatedBy' => '<string>', // REQUIRED
],
'PatchSummary' => [
'FailedCount' => <integer>,
'Id' => '<string>', // REQUIRED
'InstalledCount' => <integer>,
'InstalledOtherCount' => <integer>,
'InstalledPendingReboot' => <integer>,
'InstalledRejectedCount' => <integer>,
'MissingCount' => <integer>,
'Operation' => '<string>',
'OperationEndTime' => '<string>',
'OperationStartTime' => '<string>',
'RebootOption' => '<string>',
],
'Process' => [
'LaunchedAt' => '<string>',
'Name' => '<string>',
'ParentPid' => <integer>,
'Path' => '<string>',
'Pid' => <integer>,
'TerminatedAt' => '<string>',
],
'ProductArn' => '<string>', // REQUIRED
'ProductFields' => ['<string>', ...],
'ProductName' => '<string>',
'RecordState' => 'ACTIVE|ARCHIVED',
'Region' => '<string>',
'RelatedFindings' => [
[
'Id' => '<string>', // REQUIRED
'ProductArn' => '<string>', // REQUIRED
],
// ...
],
'Remediation' => [
'Recommendation' => [
'Text' => '<string>',
'Url' => '<string>',
],
],
'Resources' => [ // REQUIRED
[
'DataClassification' => [
'DetailedResultsLocation' => '<string>',
'Result' => [
'AdditionalOccurrences' => true || false,
'CustomDataIdentifiers' => [
'Detections' => [
[
'Arn' => '<string>',
'Count' => <integer>,
'Name' => '<string>',
'Occurrences' => [
'Cells' => [
[
'CellReference' => '<string>',
'Column' => <integer>,
'ColumnName' => '<string>',
'Row' => <integer>,
],
// ...
],
'LineRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'OffsetRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'Pages' => [
[
'LineRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'OffsetRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'PageNumber' => <integer>,
],
// ...
],
'Records' => [
[
'JsonPath' => '<string>',
'RecordIndex' => <integer>,
],
// ...
],
],
],
// ...
],
'TotalCount' => <integer>,
],
'MimeType' => '<string>',
'SensitiveData' => [
[
'Category' => '<string>',
'Detections' => [
[
'Count' => <integer>,
'Occurrences' => [
'Cells' => [
[
'CellReference' => '<string>',
'Column' => <integer>,
'ColumnName' => '<string>',
'Row' => <integer>,
],
// ...
],
'LineRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'OffsetRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'Pages' => [
[
'LineRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'OffsetRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'PageNumber' => <integer>,
],
// ...
],
'Records' => [
[
'JsonPath' => '<string>',
'RecordIndex' => <integer>,
],
// ...
],
],
'Type' => '<string>',
],
// ...
],
'TotalCount' => <integer>,
],
// ...
],
'SizeClassified' => <integer>,
'Status' => [
'Code' => '<string>',
'Reason' => '<string>',
],
],
],
'Details' => [
'AwsApiGatewayRestApi' => [
'ApiKeySource' => '<string>',
'BinaryMediaTypes' => ['<string>', ...],
'CreatedDate' => '<string>',
'Description' => '<string>',
'EndpointConfiguration' => [
'Types' => ['<string>', ...],
],
'Id' => '<string>',
'MinimumCompressionSize' => <integer>,
'Name' => '<string>',
'Version' => '<string>',
],
'AwsApiGatewayStage' => [
'AccessLogSettings' => [
'DestinationArn' => '<string>',
'Format' => '<string>',
],
'CacheClusterEnabled' => true || false,
'CacheClusterSize' => '<string>',
'CacheClusterStatus' => '<string>',
'CanarySettings' => [
'DeploymentId' => '<string>',
'PercentTraffic' => <float>,
'StageVariableOverrides' => ['<string>', ...],
'UseStageCache' => true || false,
],
'ClientCertificateId' => '<string>',
'CreatedDate' => '<string>',
'DeploymentId' => '<string>',
'Description' => '<string>',
'DocumentationVersion' => '<string>',
'LastUpdatedDate' => '<string>',
'MethodSettings' => [
[
'CacheDataEncrypted' => true || false,
'CacheTtlInSeconds' => <integer>,
'CachingEnabled' => true || false,
'DataTraceEnabled' => true || false,
'HttpMethod' => '<string>',
'LoggingLevel' => '<string>',
'MetricsEnabled' => true || false,
'RequireAuthorizationForCacheControl' => true || false,
'ResourcePath' => '<string>',
'ThrottlingBurstLimit' => <integer>,
'ThrottlingRateLimit' => <float>,
'UnauthorizedCacheControlHeaderStrategy' => '<string>',
],
// ...
],
'StageName' => '<string>',
'TracingEnabled' => true || false,
'Variables' => ['<string>', ...],
'WebAclArn' => '<string>',
],
'AwsApiGatewayV2Api' => [
'ApiEndpoint' => '<string>',
'ApiId' => '<string>',
'ApiKeySelectionExpression' => '<string>',
'CorsConfiguration' => [
'AllowCredentials' => true || false,
'AllowHeaders' => ['<string>', ...],
'AllowMethods' => ['<string>', ...],
'AllowOrigins' => ['<string>', ...],
'ExposeHeaders' => ['<string>', ...],
'MaxAge' => <integer>,
],
'CreatedDate' => '<string>',
'Description' => '<string>',
'Name' => '<string>',
'ProtocolType' => '<string>',
'RouteSelectionExpression' => '<string>',
'Version' => '<string>',
],
'AwsApiGatewayV2Stage' => [
'AccessLogSettings' => [
'DestinationArn' => '<string>',
'Format' => '<string>',
],
'ApiGatewayManaged' => true || false,
'AutoDeploy' => true || false,
'ClientCertificateId' => '<string>',
'CreatedDate' => '<string>',
'DefaultRouteSettings' => [
'DataTraceEnabled' => true || false,
'DetailedMetricsEnabled' => true || false,
'LoggingLevel' => '<string>',
'ThrottlingBurstLimit' => <integer>,
'ThrottlingRateLimit' => <float>,
],
'DeploymentId' => '<string>',
'Description' => '<string>',
'LastDeploymentStatusMessage' => '<string>',
'LastUpdatedDate' => '<string>',
'RouteSettings' => [
'DataTraceEnabled' => true || false,
'DetailedMetricsEnabled' => true || false,
'LoggingLevel' => '<string>',
'ThrottlingBurstLimit' => <integer>,
'ThrottlingRateLimit' => <float>,
],
'StageName' => '<string>',
'StageVariables' => ['<string>', ...],
],
'AwsAutoScalingAutoScalingGroup' => [
'CreatedTime' => '<string>',
'HealthCheckGracePeriod' => <integer>,
'HealthCheckType' => '<string>',
'LaunchConfigurationName' => '<string>',
'LoadBalancerNames' => ['<string>', ...],
],
'AwsCertificateManagerCertificate' => [
'CertificateAuthorityArn' => '<string>',
'CreatedAt' => '<string>',
'DomainName' => '<string>',
'DomainValidationOptions' => [
[
'DomainName' => '<string>',
'ResourceRecord' => [
'Name' => '<string>',
'Type' => '<string>',
'Value' => '<string>',
],
'ValidationDomain' => '<string>',
'ValidationEmails' => ['<string>', ...],
'ValidationMethod' => '<string>',
'ValidationStatus' => '<string>',
],
// ...
],
'ExtendedKeyUsages' => [
[
'Name' => '<string>',
'OId' => '<string>',
],
// ...
],
'FailureReason' => '<string>',
'ImportedAt' => '<string>',
'InUseBy' => ['<string>', ...],
'IssuedAt' => '<string>',
'Issuer' => '<string>',
'KeyAlgorithm' => '<string>',
'KeyUsages' => [
[
'Name' => '<string>',
],
// ...
],
'NotAfter' => '<string>',
'NotBefore' => '<string>',
'Options' => [
'CertificateTransparencyLoggingPreference' => '<string>',
],
'RenewalEligibility' => '<string>',
'RenewalSummary' => [
'DomainValidationOptions' => [
[
'DomainName' => '<string>',
'ResourceRecord' => [
'Name' => '<string>',
'Type' => '<string>',
'Value' => '<string>',
],
'ValidationDomain' => '<string>',
'ValidationEmails' => ['<string>', ...],
'ValidationMethod' => '<string>',
'ValidationStatus' => '<string>',
],
// ...
],
'RenewalStatus' => '<string>',
'RenewalStatusReason' => '<string>',
'UpdatedAt' => '<string>',
],
'Serial' => '<string>',
'SignatureAlgorithm' => '<string>',
'Status' => '<string>',
'Subject' => '<string>',
'SubjectAlternativeNames' => ['<string>', ...],
'Type' => '<string>',
],
'AwsCloudFrontDistribution' => [
'CacheBehaviors' => [
'Items' => [
[
'ViewerProtocolPolicy' => '<string>',
],
// ...
],
],
'DefaultCacheBehavior' => [
'ViewerProtocolPolicy' => '<string>',
],
'DefaultRootObject' => '<string>',
'DomainName' => '<string>',
'ETag' => '<string>',
'LastModifiedTime' => '<string>',
'Logging' => [
'Bucket' => '<string>',
'Enabled' => true || false,
'IncludeCookies' => true || false,
'Prefix' => '<string>',
],
'OriginGroups' => [
'Items' => [
[
'FailoverCriteria' => [
'StatusCodes' => [
'Items' => [<integer>, ...],
'Quantity' => <integer>,
],
],
],
// ...
],
],
'Origins' => [
'Items' => [
[
'DomainName' => '<string>',
'Id' => '<string>',
'OriginPath' => '<string>',
'S3OriginConfig' => [
'OriginAccessIdentity' => '<string>',
],
],
// ...
],
],
'Status' => '<string>',
'WebAclId' => '<string>',
],
'AwsCloudTrailTrail' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'CloudWatchLogsRoleArn' => '<string>',
'HasCustomEventSelectors' => true || false,
'HomeRegion' => '<string>',
'IncludeGlobalServiceEvents' => true || false,
'IsMultiRegionTrail' => true || false,
'IsOrganizationTrail' => true || false,
'KmsKeyId' => '<string>',
'LogFileValidationEnabled' => true || false,
'Name' => '<string>',
'S3BucketName' => '<string>',
'S3KeyPrefix' => '<string>',
'SnsTopicArn' => '<string>',
'SnsTopicName' => '<string>',
'TrailArn' => '<string>',
],
'AwsCodeBuildProject' => [
'EncryptionKey' => '<string>',
'Environment' => [
'Certificate' => '<string>',
'ImagePullCredentialsType' => '<string>',
'RegistryCredential' => [
'Credential' => '<string>',
'CredentialProvider' => '<string>',
],
'Type' => '<string>',
],
'Name' => '<string>',
'ServiceRole' => '<string>',
'Source' => [
'GitCloneDepth' => <integer>,
'InsecureSsl' => true || false,
'Location' => '<string>',
'Type' => '<string>',
],
'VpcConfig' => [
'SecurityGroupIds' => ['<string>', ...],
'Subnets' => ['<string>', ...],
'VpcId' => '<string>',
],
],
'AwsDynamoDbTable' => [
'AttributeDefinitions' => [
[
'AttributeName' => '<string>',
'AttributeType' => '<string>',
],
// ...
],
'BillingModeSummary' => [
'BillingMode' => '<string>',
'LastUpdateToPayPerRequestDateTime' => '<string>',
],
'CreationDateTime' => '<string>',
'GlobalSecondaryIndexes' => [
[
'Backfilling' => true || false,
'IndexArn' => '<string>',
'IndexName' => '<string>',
'IndexSizeBytes' => <integer>,
'IndexStatus' => '<string>',
'ItemCount' => <integer>,
'KeySchema' => [
[
'AttributeName' => '<string>',
'KeyType' => '<string>',
],
// ...
],
'Projection' => [
'NonKeyAttributes' => ['<string>', ...],
'ProjectionType' => '<string>',
],
'ProvisionedThroughput' => [
'LastDecreaseDateTime' => '<string>',
'LastIncreaseDateTime' => '<string>',
'NumberOfDecreasesToday' => <integer>,
'ReadCapacityUnits' => <integer>,
'WriteCapacityUnits' => <integer>,
],
],
// ...
],
'GlobalTableVersion' => '<string>',
'ItemCount' => <integer>,
'KeySchema' => [
[
'AttributeName' => '<string>',
'KeyType' => '<string>',
],
// ...
],
'LatestStreamArn' => '<string>',
'LatestStreamLabel' => '<string>',
'LocalSecondaryIndexes' => [
[
'IndexArn' => '<string>',
'IndexName' => '<string>',
'KeySchema' => [
[
'AttributeName' => '<string>',
'KeyType' => '<string>',
],
// ...
],
'Projection' => [
'NonKeyAttributes' => ['<string>', ...],
'ProjectionType' => '<string>',
],
],
// ...
],
'ProvisionedThroughput' => [
'LastDecreaseDateTime' => '<string>',
'LastIncreaseDateTime' => '<string>',
'NumberOfDecreasesToday' => <integer>,
'ReadCapacityUnits' => <integer>,
'WriteCapacityUnits' => <integer>,
],
'Replicas' => [
[
'GlobalSecondaryIndexes' => [
[
'IndexName' => '<string>',
'ProvisionedThroughputOverride' => [
'ReadCapacityUnits' => <integer>,
],
],
// ...
],
'KmsMasterKeyId' => '<string>',
'ProvisionedThroughputOverride' => [
'ReadCapacityUnits' => <integer>,
],
'RegionName' => '<string>',
'ReplicaStatus' => '<string>',
'ReplicaStatusDescription' => '<string>',
],
// ...
],
'RestoreSummary' => [
'RestoreDateTime' => '<string>',
'RestoreInProgress' => true || false,
'SourceBackupArn' => '<string>',
'SourceTableArn' => '<string>',
],
'SseDescription' => [
'InaccessibleEncryptionDateTime' => '<string>',
'KmsMasterKeyArn' => '<string>',
'SseType' => '<string>',
'Status' => '<string>',
],
'StreamSpecification' => [
'StreamEnabled' => true || false,
'StreamViewType' => '<string>',
],
'TableId' => '<string>',
'TableName' => '<string>',
'TableSizeBytes' => <integer>,
'TableStatus' => '<string>',
],
'AwsEc2Eip' => [
'AllocationId' => '<string>',
'AssociationId' => '<string>',
'Domain' => '<string>',
'InstanceId' => '<string>',
'NetworkBorderGroup' => '<string>',
'NetworkInterfaceId' => '<string>',
'NetworkInterfaceOwnerId' => '<string>',
'PrivateIpAddress' => '<string>',
'PublicIp' => '<string>',
'PublicIpv4Pool' => '<string>',
],
'AwsEc2Instance' => [
'IamInstanceProfileArn' => '<string>',
'ImageId' => '<string>',
'IpV4Addresses' => ['<string>', ...],
'IpV6Addresses' => ['<string>', ...],
'KeyName' => '<string>',
'LaunchedAt' => '<string>',
'NetworkInterfaces' => [
[
'NetworkInterfaceId' => '<string>',
],
// ...
],
'SubnetId' => '<string>',
'Type' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2NetworkAcl' => [
'Associations' => [
[
'NetworkAclAssociationId' => '<string>',
'NetworkAclId' => '<string>',
'SubnetId' => '<string>',
],
// ...
],
'Entries' => [
[
'CidrBlock' => '<string>',
'Egress' => true || false,
'IcmpTypeCode' => [
'Code' => <integer>,
'Type' => <integer>,
],
'Ipv6CidrBlock' => '<string>',
'PortRange' => [
'From' => <integer>,
'To' => <integer>,
],
'Protocol' => '<string>',
'RuleAction' => '<string>',
'RuleNumber' => <integer>,
],
// ...
],
'IsDefault' => true || false,
'NetworkAclId' => '<string>',
'OwnerId' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2NetworkInterface' => [
'Attachment' => [
'AttachTime' => '<string>',
'AttachmentId' => '<string>',
'DeleteOnTermination' => true || false,
'DeviceIndex' => <integer>,
'InstanceId' => '<string>',
'InstanceOwnerId' => '<string>',
'Status' => '<string>',
],
'IpV6Addresses' => [
[
'IpV6Address' => '<string>',
],
// ...
],
'NetworkInterfaceId' => '<string>',
'PrivateIpAddresses' => [
[
'PrivateDnsName' => '<string>',
'PrivateIpAddress' => '<string>',
],
// ...
],
'PublicDnsName' => '<string>',
'PublicIp' => '<string>',
'SecurityGroups' => [
[
'GroupId' => '<string>',
'GroupName' => '<string>',
],
// ...
],
'SourceDestCheck' => true || false,
],
'AwsEc2SecurityGroup' => [
'GroupId' => '<string>',
'GroupName' => '<string>',
'IpPermissions' => [
[
'FromPort' => <integer>,
'IpProtocol' => '<string>',
'IpRanges' => [
[
'CidrIp' => '<string>',
],
// ...
],
'Ipv6Ranges' => [
[
'CidrIpv6' => '<string>',
],
// ...
],
'PrefixListIds' => [
[
'PrefixListId' => '<string>',
],
// ...
],
'ToPort' => <integer>,
'UserIdGroupPairs' => [
[
'GroupId' => '<string>',
'GroupName' => '<string>',
'PeeringStatus' => '<string>',
'UserId' => '<string>',
'VpcId' => '<string>',
'VpcPeeringConnectionId' => '<string>',
],
// ...
],
],
// ...
],
'IpPermissionsEgress' => [
[
'FromPort' => <integer>,
'IpProtocol' => '<string>',
'IpRanges' => [
[
'CidrIp' => '<string>',
],
// ...
],
'Ipv6Ranges' => [
[
'CidrIpv6' => '<string>',
],
// ...
],
'PrefixListIds' => [
[
'PrefixListId' => '<string>',
],
// ...
],
'ToPort' => <integer>,
'UserIdGroupPairs' => [
[
'GroupId' => '<string>',
'GroupName' => '<string>',
'PeeringStatus' => '<string>',
'UserId' => '<string>',
'VpcId' => '<string>',
'VpcPeeringConnectionId' => '<string>',
],
// ...
],
],
// ...
],
'OwnerId' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2Subnet' => [
'AssignIpv6AddressOnCreation' => true || false,
'AvailabilityZone' => '<string>',
'AvailabilityZoneId' => '<string>',
'AvailableIpAddressCount' => <integer>,
'CidrBlock' => '<string>',
'DefaultForAz' => true || false,
'Ipv6CidrBlockAssociationSet' => [
[
'AssociationId' => '<string>',
'CidrBlockState' => '<string>',
'Ipv6CidrBlock' => '<string>',
],
// ...
],
'MapPublicIpOnLaunch' => true || false,
'OwnerId' => '<string>',
'State' => '<string>',
'SubnetArn' => '<string>',
'SubnetId' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2Volume' => [
'Attachments' => [
[
'AttachTime' => '<string>',
'DeleteOnTermination' => true || false,
'InstanceId' => '<string>',
'Status' => '<string>',
],
// ...
],
'CreateTime' => '<string>',
'Encrypted' => true || false,
'KmsKeyId' => '<string>',
'Size' => <integer>,
'SnapshotId' => '<string>',
'Status' => '<string>',
],
'AwsEc2Vpc' => [
'CidrBlockAssociationSet' => [
[
'AssociationId' => '<string>',
'CidrBlock' => '<string>',
'CidrBlockState' => '<string>',
],
// ...
],
'DhcpOptionsId' => '<string>',
'Ipv6CidrBlockAssociationSet' => [
[
'AssociationId' => '<string>',
'CidrBlockState' => '<string>',
'Ipv6CidrBlock' => '<string>',
],
// ...
],
'State' => '<string>',
],
'AwsEcsCluster' => [
'CapacityProviders' => ['<string>', ...],
'ClusterSettings' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'Configuration' => [
'ExecuteCommandConfiguration' => [
'KmsKeyId' => '<string>',
'LogConfiguration' => [
'CloudWatchEncryptionEnabled' => true || false,
'CloudWatchLogGroupName' => '<string>',
'S3BucketName' => '<string>',
'S3EncryptionEnabled' => true || false,
'S3KeyPrefix' => '<string>',
],
'Logging' => '<string>',
],
],
'DefaultCapacityProviderStrategy' => [
[
'Base' => <integer>,
'CapacityProvider' => '<string>',
'Weight' => <integer>,
],
// ...
],
],
'AwsEcsService' => [
'CapacityProviderStrategy' => [
[
'Base' => <integer>,
'CapacityProvider' => '<string>',
'Weight' => <integer>,
],
// ...
],
'Cluster' => '<string>',
'DeploymentConfiguration' => [
'DeploymentCircuitBreaker' => [
'Enable' => true || false,
'Rollback' => true || false,
],
'MaximumPercent' => <integer>,
'MinimumHealthyPercent' => <integer>,
],
'DeploymentController' => [
'Type' => '<string>',
],
'DesiredCount' => <integer>,
'EnableEcsManagedTags' => true || false,
'EnableExecuteCommand' => true || false,
'HealthCheckGracePeriodSeconds' => <integer>,
'LaunchType' => '<string>',
'LoadBalancers' => [
[
'ContainerName' => '<string>',
'ContainerPort' => <integer>,
'LoadBalancerName' => '<string>',
'TargetGroupArn' => '<string>',
],
// ...
],
'Name' => '<string>',
'NetworkConfiguration' => [
'AwsVpcConfiguration' => [
'AssignPublicIp' => '<string>',
'SecurityGroups' => ['<string>', ...],
'Subnets' => ['<string>', ...],
],
],
'PlacementConstraints' => [
[
'Expression' => '<string>',
'Type' => '<string>',
],
// ...
],
'PlacementStrategies' => [
[
'Field' => '<string>',
'Type' => '<string>',
],
// ...
],
'PlatformVersion' => '<string>',
'PropagateTags' => '<string>',
'Role' => '<string>',
'SchedulingStrategy' => '<string>',
'ServiceArn' => '<string>',
'ServiceName' => '<string>',
'ServiceRegistries' => [
[
'ContainerName' => '<string>',
'ContainerPort' => <integer>,
'Port' => <integer>,
'RegistryArn' => '<string>',
],
// ...
],
'TaskDefinition' => '<string>',
],
'AwsEcsTaskDefinition' => [
'ContainerDefinitions' => [
[
'Command' => ['<string>', ...],
'Cpu' => <integer>,
'DependsOn' => [
[
'Condition' => '<string>',
'ContainerName' => '<string>',
],
// ...
],
'DisableNetworking' => true || false,
'DnsSearchDomains' => ['<string>', ...],
'DnsServers' => ['<string>', ...],
'DockerLabels' => ['<string>', ...],
'DockerSecurityOptions' => ['<string>', ...],
'EntryPoint' => ['<string>', ...],
'Environment' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'EnvironmentFiles' => [
[
'Type' => '<string>',
'Value' => '<string>',
],
// ...
],
'Essential' => true || false,
'ExtraHosts' => [
[
'Hostname' => '<string>',
'IpAddress' => '<string>',
],
// ...
],
'FirelensConfiguration' => [
'Options' => ['<string>', ...],
'Type' => '<string>',
],
'HealthCheck' => [
'Command' => ['<string>', ...],
'Interval' => <integer>,
'Retries' => <integer>,
'StartPeriod' => <integer>,
'Timeout' => <integer>,
],
'Hostname' => '<string>',
'Image' => '<string>',
'Interactive' => true || false,
'Links' => ['<string>', ...],
'LinuxParameters' => [
'Capabilities' => [
'Add' => ['<string>', ...],
'Drop' => ['<string>', ...],
],
'Devices' => [
[
'ContainerPath' => '<string>',
'HostPath' => '<string>',
'Permissions' => ['<string>', ...],
],
// ...
],
'InitProcessEnabled' => true || false,
'MaxSwap' => <integer>,
'SharedMemorySize' => <integer>,
'Swappiness' => <integer>,
'Tmpfs' => [
[
'ContainerPath' => '<string>',
'MountOptions' => ['<string>', ...],
'Size' => <integer>,
],
// ...
],
],
'LogConfiguration' => [
'LogDriver' => '<string>',
'Options' => ['<string>', ...],
'SecretOptions' => [
[
'Name' => '<string>',
'ValueFrom' => '<string>',
],
// ...
],
],
'Memory' => <integer>,
'MemoryReservation' => <integer>,
'MountPoints' => [
[
'ContainerPath' => '<string>',
'ReadOnly' => true || false,
'SourceVolume' => '<string>',
],
// ...
],
'Name' => '<string>',
'PortMappings' => [
[
'ContainerPort' => <integer>,
'HostPort' => <integer>,
'Protocol' => '<string>',
],
// ...
],
'Privileged' => true || false,
'PseudoTerminal' => true || false,
'ReadonlyRootFilesystem' => true || false,
'RepositoryCredentials' => [
'CredentialsParameter' => '<string>',
],
'ResourceRequirements' => [
[
'Type' => '<string>',
'Value' => '<string>',
],
// ...
],
'Secrets' => [
[
'Name' => '<string>',
'ValueFrom' => '<string>',
],
// ...
],
'StartTimeout' => <integer>,
'StopTimeout' => <integer>,
'SystemControls' => [
[
'Namespace' => '<string>',
'Value' => '<string>',
],
// ...
],
'Ulimits' => [
[
'HardLimit' => <integer>,
'Name' => '<string>',
'SoftLimit' => <integer>,
],
// ...
],
'User' => '<string>',
'VolumesFrom' => [
[
'ReadOnly' => true || false,
'SourceContainer' => '<string>',
],
// ...
],
'WorkingDirectory' => '<string>',
],
// ...
],
'Cpu' => '<string>',
'ExecutionRoleArn' => '<string>',
'Family' => '<string>',
'InferenceAccelerators' => [
[
'DeviceName' => '<string>',
'DeviceType' => '<string>',
],
// ...
],
'IpcMode' => '<string>',
'Memory' => '<string>',
'NetworkMode' => '<string>',
'PidMode' => '<string>',
'PlacementConstraints' => [
[
'Expression' => '<string>',
'Type' => '<string>',
],
// ...
],
'ProxyConfiguration' => [
'ContainerName' => '<string>',
'ProxyConfigurationProperties' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'Type' => '<string>',
],
'RequiresCompatibilities' => ['<string>', ...],
'TaskRoleArn' => '<string>',
'Volumes' => [
[
'DockerVolumeConfiguration' => [
'Autoprovision' => true || false,
'Driver' => '<string>',
'DriverOpts' => ['<string>', ...],
'Labels' => ['<string>', ...],
'Scope' => '<string>',
],
'EfsVolumeConfiguration' => [
'AuthorizationConfig' => [
'AccessPointId' => '<string>',
'Iam' => '<string>',
],
'FilesystemId' => '<string>',
'RootDirectory' => '<string>',
'TransitEncryption' => '<string>',
'TransitEncryptionPort' => <integer>,
],
'Host' => [
'SourcePath' => '<string>',
],
'Name' => '<string>',
],
// ...
],
],
'AwsElasticBeanstalkEnvironment' => [
'ApplicationName' => '<string>',
'Cname' => '<string>',
'DateCreated' => '<string>',
'DateUpdated' => '<string>',
'Description' => '<string>',
'EndpointUrl' => '<string>',
'EnvironmentArn' => '<string>',
'EnvironmentId' => '<string>',
'EnvironmentLinks' => [
[
'EnvironmentName' => '<string>',
'LinkName' => '<string>',
],
// ...
],
'EnvironmentName' => '<string>',
'OptionSettings' => [
[
'Namespace' => '<string>',
'OptionName' => '<string>',
'ResourceName' => '<string>',
'Value' => '<string>',
],
// ...
],
'PlatformArn' => '<string>',
'SolutionStackName' => '<string>',
'Status' => '<string>',
'Tier' => [
'Name' => '<string>',
'Type' => '<string>',
'Version' => '<string>',
],
'VersionLabel' => '<string>',
],
'AwsElasticsearchDomain' => [
'AccessPolicies' => '<string>',
'DomainEndpointOptions' => [
'EnforceHTTPS' => true || false,
'TLSSecurityPolicy' => '<string>',
],
'DomainId' => '<string>',
'DomainName' => '<string>',
'ElasticsearchClusterConfig' => [
'DedicatedMasterCount' => <integer>,
'DedicatedMasterEnabled' => true || false,
'DedicatedMasterType' => '<string>',
'InstanceCount' => <integer>,
'InstanceType' => '<string>',
'ZoneAwarenessConfig' => [
'AvailabilityZoneCount' => <integer>,
],
'ZoneAwarenessEnabled' => true || false,
],
'ElasticsearchVersion' => '<string>',
'EncryptionAtRestOptions' => [
'Enabled' => true || false,
'KmsKeyId' => '<string>',
],
'Endpoint' => '<string>',
'Endpoints' => ['<string>', ...],
'LogPublishingOptions' => [
'AuditLogs' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'Enabled' => true || false,
],
'IndexSlowLogs' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'Enabled' => true || false,
],
'SearchSlowLogs' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'Enabled' => true || false,
],
],
'NodeToNodeEncryptionOptions' => [
'Enabled' => true || false,
],
'ServiceSoftwareOptions' => [
'AutomatedUpdateDate' => '<string>',
'Cancellable' => true || false,
'CurrentVersion' => '<string>',
'Description' => '<string>',
'NewVersion' => '<string>',
'UpdateAvailable' => true || false,
'UpdateStatus' => '<string>',
],
'VPCOptions' => [
'AvailabilityZones' => ['<string>', ...],
'SecurityGroupIds' => ['<string>', ...],
'SubnetIds' => ['<string>', ...],
'VPCId' => '<string>',
],
],
'AwsElbLoadBalancer' => [
'AvailabilityZones' => ['<string>', ...],
'BackendServerDescriptions' => [
[
'InstancePort' => <integer>,
'PolicyNames' => ['<string>', ...],
],
// ...
],
'CanonicalHostedZoneName' => '<string>',
'CanonicalHostedZoneNameID' => '<string>',
'CreatedTime' => '<string>',
'DnsName' => '<string>',
'HealthCheck' => [
'HealthyThreshold' => <integer>,
'Interval' => <integer>,
'Target' => '<string>',
'Timeout' => <integer>,
'UnhealthyThreshold' => <integer>,
],
'Instances' => [
[
'InstanceId' => '<string>',
],
// ...
],
'ListenerDescriptions' => [
[
'Listener' => [
'InstancePort' => <integer>,
'InstanceProtocol' => '<string>',
'LoadBalancerPort' => <integer>,
'Protocol' => '<string>',
'SslCertificateId' => '<string>',
],
'PolicyNames' => ['<string>', ...],
],
// ...
],
'LoadBalancerAttributes' => [
'AccessLog' => [
'EmitInterval' => <integer>,
'Enabled' => true || false,
'S3BucketName' => '<string>',
'S3BucketPrefix' => '<string>',
],
'ConnectionDraining' => [
'Enabled' => true || false,
'Timeout' => <integer>,
],
'ConnectionSettings' => [
'IdleTimeout' => <integer>,
],
'CrossZoneLoadBalancing' => [
'Enabled' => true || false,
],
],
'LoadBalancerName' => '<string>',
'Policies' => [
'AppCookieStickinessPolicies' => [
[
'CookieName' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'LbCookieStickinessPolicies' => [
[
'CookieExpirationPeriod' => <integer>,
'PolicyName' => '<string>',
],
// ...
],
'OtherPolicies' => ['<string>', ...],
],
'Scheme' => '<string>',
'SecurityGroups' => ['<string>', ...],
'SourceSecurityGroup' => [
'GroupName' => '<string>',
'OwnerAlias' => '<string>',
],
'Subnets' => ['<string>', ...],
'VpcId' => '<string>',
],
'AwsElbv2LoadBalancer' => [
'AvailabilityZones' => [
[
'SubnetId' => '<string>',
'ZoneName' => '<string>',
],
// ...
],
'CanonicalHostedZoneId' => '<string>',
'CreatedTime' => '<string>',
'DNSName' => '<string>',
'IpAddressType' => '<string>',
'Scheme' => '<string>',
'SecurityGroups' => ['<string>', ...],
'State' => [
'Code' => '<string>',
'Reason' => '<string>',
],
'Type' => '<string>',
'VpcId' => '<string>',
],
'AwsIamAccessKey' => [
'AccessKeyId' => '<string>',
'AccountId' => '<string>',
'CreatedAt' => '<string>',
'PrincipalId' => '<string>',
'PrincipalName' => '<string>',
'PrincipalType' => '<string>',
'SessionContext' => [
'Attributes' => [
'CreationDate' => '<string>',
'MfaAuthenticated' => true || false,
],
'SessionIssuer' => [
'AccountId' => '<string>',
'Arn' => '<string>',
'PrincipalId' => '<string>',
'Type' => '<string>',
'UserName' => '<string>',
],
],
'Status' => 'Active|Inactive',
'UserName' => '<string>',
],
'AwsIamGroup' => [
'AttachedManagedPolicies' => [
[
'PolicyArn' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'CreateDate' => '<string>',
'GroupId' => '<string>',
'GroupName' => '<string>',
'GroupPolicyList' => [
[
'PolicyName' => '<string>',
],
// ...
],
'Path' => '<string>',
],
'AwsIamPolicy' => [
'AttachmentCount' => <integer>,
'CreateDate' => '<string>',
'DefaultVersionId' => '<string>',
'Description' => '<string>',
'IsAttachable' => true || false,
'Path' => '<string>',
'PermissionsBoundaryUsageCount' => <integer>,
'PolicyId' => '<string>',
'PolicyName' => '<string>',
'PolicyVersionList' => [
[
'CreateDate' => '<string>',
'IsDefaultVersion' => true || false,
'VersionId' => '<string>',
],
// ...
],
'UpdateDate' => '<string>',
],
'AwsIamRole' => [
'AssumeRolePolicyDocument' => '<string>',
'AttachedManagedPolicies' => [
[
'PolicyArn' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'CreateDate' => '<string>',
'InstanceProfileList' => [
[
'Arn' => '<string>',
'CreateDate' => '<string>',
'InstanceProfileId' => '<string>',
'InstanceProfileName' => '<string>',
'Path' => '<string>',
'Roles' => [
[
'Arn' => '<string>',
'AssumeRolePolicyDocument' => '<string>',
'CreateDate' => '<string>',
'Path' => '<string>',
'RoleId' => '<string>',
'RoleName' => '<string>',
],
// ...
],
],
// ...
],
'MaxSessionDuration' => <integer>,
'Path' => '<string>',
'PermissionsBoundary' => [
'PermissionsBoundaryArn' => '<string>',
'PermissionsBoundaryType' => '<string>',
],
'RoleId' => '<string>',
'RoleName' => '<string>',
'RolePolicyList' => [
[
'PolicyName' => '<string>',
],
// ...
],
],
'AwsIamUser' => [
'AttachedManagedPolicies' => [
[
'PolicyArn' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'CreateDate' => '<string>',
'GroupList' => ['<string>', ...],
'Path' => '<string>',
'PermissionsBoundary' => [
'PermissionsBoundaryArn' => '<string>',
'PermissionsBoundaryType' => '<string>',
],
'UserId' => '<string>',
'UserName' => '<string>',
'UserPolicyList' => [
[
'PolicyName' => '<string>',
],
// ...
],
],
'AwsKmsKey' => [
'AWSAccountId' => '<string>',
'CreationDate' => <float>,
'Description' => '<string>',
'KeyId' => '<string>',
'KeyManager' => '<string>',
'KeyState' => '<string>',
'Origin' => '<string>',
],
'AwsLambdaFunction' => [
'Code' => [
'S3Bucket' => '<string>',
'S3Key' => '<string>',
'S3ObjectVersion' => '<string>',
'ZipFile' => '<string>',
],
'CodeSha256' => '<string>',
'DeadLetterConfig' => [
'TargetArn' => '<string>',
],
'Environment' => [
'Error' => [
'ErrorCode' => '<string>',
'Message' => '<string>',
],
'Variables' => ['<string>', ...],
],
'FunctionName' => '<string>',
'Handler' => '<string>',
'KmsKeyArn' => '<string>',
'LastModified' => '<string>',
'Layers' => [
[
'Arn' => '<string>',
'CodeSize' => <integer>,
],
// ...
],
'MasterArn' => '<string>',
'MemorySize' => <integer>,
'RevisionId' => '<string>',
'Role' => '<string>',
'Runtime' => '<string>',
'Timeout' => <integer>,
'TracingConfig' => [
'Mode' => '<string>',
],
'Version' => '<string>',
'VpcConfig' => [
'SecurityGroupIds' => ['<string>', ...],
'SubnetIds' => ['<string>', ...],
'VpcId' => '<string>',
],
],
'AwsLambdaLayerVersion' => [
'CompatibleRuntimes' => ['<string>', ...],
'CreatedDate' => '<string>',
'Version' => <integer>,
],
'AwsRdsDbCluster' => [
'ActivityStreamStatus' => '<string>',
'AllocatedStorage' => <integer>,
'AssociatedRoles' => [
[
'RoleArn' => '<string>',
'Status' => '<string>',
],
// ...
],
'AvailabilityZones' => ['<string>', ...],
'BackupRetentionPeriod' => <integer>,
'ClusterCreateTime' => '<string>',
'CopyTagsToSnapshot' => true || false,
'CrossAccountClone' => true || false,
'CustomEndpoints' => ['<string>', ...],
'DatabaseName' => '<string>',
'DbClusterIdentifier' => '<string>',
'DbClusterMembers' => [
[
'DbClusterParameterGroupStatus' => '<string>',
'DbInstanceIdentifier' => '<string>',
'IsClusterWriter' => true || false,
'PromotionTier' => <integer>,
],
// ...
],
'DbClusterOptionGroupMemberships' => [
[
'DbClusterOptionGroupName' => '<string>',
'Status' => '<string>',
],
// ...
],
'DbClusterParameterGroup' => '<string>',
'DbClusterResourceId' => '<string>',
'DbSubnetGroup' => '<string>',
'DeletionProtection' => true || false,
'DomainMemberships' => [
[
'Domain' => '<string>',
'Fqdn' => '<string>',
'IamRoleName' => '<string>',
'Status' => '<string>',
],
// ...
],
'EnabledCloudWatchLogsExports' => ['<string>', ...],
'Endpoint' => '<string>',
'Engine' => '<string>',
'EngineMode' => '<string>',
'EngineVersion' => '<string>',
'HostedZoneId' => '<string>',
'HttpEndpointEnabled' => true || false,
'IamDatabaseAuthenticationEnabled' => true || false,
'KmsKeyId' => '<string>',
'MasterUsername' => '<string>',
'MultiAz' => true || false,
'Port' => <integer>,
'PreferredBackupWindow' => '<string>',
'PreferredMaintenanceWindow' => '<string>',
'ReadReplicaIdentifiers' => ['<string>', ...],
'ReaderEndpoint' => '<string>',
'Status' => '<string>',
'StorageEncrypted' => true || false,
'VpcSecurityGroups' => [
[
'Status' => '<string>',
'VpcSecurityGroupId' => '<string>',
],
// ...
],
],
'AwsRdsDbClusterSnapshot' => [
'AllocatedStorage' => <integer>,
'AvailabilityZones' => ['<string>', ...],
'ClusterCreateTime' => '<string>',
'DbClusterIdentifier' => '<string>',
'DbClusterSnapshotIdentifier' => '<string>',
'Engine' => '<string>',
'EngineVersion' => '<string>',
'IamDatabaseAuthenticationEnabled' => true || false,
'KmsKeyId' => '<string>',
'LicenseModel' => '<string>',
'MasterUsername' => '<string>',
'PercentProgress' => <integer>,
'Port' => <integer>,
'SnapshotCreateTime' => '<string>',
'SnapshotType' => '<string>',
'Status' => '<string>',
'StorageEncrypted' => true || false,
'VpcId' => '<string>',
],
'AwsRdsDbInstance' => [
'AllocatedStorage' => <integer>,
'AssociatedRoles' => [
[
'FeatureName' => '<string>',
'RoleArn' => '<string>',
'Status' => '<string>',
],
// ...
],
'AutoMinorVersionUpgrade' => true || false,
'AvailabilityZone' => '<string>',
'BackupRetentionPeriod' => <integer>,
'CACertificateIdentifier' => '<string>',
'CharacterSetName' => '<string>',
'CopyTagsToSnapshot' => true || false,
'DBClusterIdentifier' => '<string>',
'DBInstanceClass' => '<string>',
'DBInstanceIdentifier' => '<string>',
'DBName' => '<string>',
'DbInstancePort' => <integer>,
'DbInstanceStatus' => '<string>',
'DbParameterGroups' => [
[
'DbParameterGroupName' => '<string>',
'ParameterApplyStatus' => '<string>',
],
// ...
],
'DbSecurityGroups' => ['<string>', ...],
'DbSubnetGroup' => [
'DbSubnetGroupArn' => '<string>',
'DbSubnetGroupDescription' => '<string>',
'DbSubnetGroupName' => '<string>',
'SubnetGroupStatus' => '<string>',
'Subnets' => [
[
'SubnetAvailabilityZone' => [
'Name' => '<string>',
],
'SubnetIdentifier' => '<string>',
'SubnetStatus' => '<string>',
],
// ...
],
'VpcId' => '<string>',
],
'DbiResourceId' => '<string>',
'DeletionProtection' => true || false,
'DomainMemberships' => [
[
'Domain' => '<string>',
'Fqdn' => '<string>',
'IamRoleName' => '<string>',
'Status' => '<string>',
],
// ...
],
'EnabledCloudWatchLogsExports' => ['<string>', ...],
'Endpoint' => [
'Address' => '<string>',
'HostedZoneId' => '<string>',
'Port' => <integer>,
],
'Engine' => '<string>',
'EngineVersion' => '<string>',
'EnhancedMonitoringResourceArn' => '<string>',
'IAMDatabaseAuthenticationEnabled' => true || false,
'InstanceCreateTime' => '<string>',
'Iops' => <integer>,
'KmsKeyId' => '<string>',
'LatestRestorableTime' => '<string>',
'LicenseModel' => '<string>',
'ListenerEndpoint' => [
'Address' => '<string>',
'HostedZoneId' => '<string>',
'Port' => <integer>,
],
'MasterUsername' => '<string>',
'MaxAllocatedStorage' => <integer>,
'MonitoringInterval' => <integer>,
'MonitoringRoleArn' => '<string>',
'MultiAz' => true || false,
'OptionGroupMemberships' => [
[
'OptionGroupName' => '<string>',
'Status' => '<string>',
],
// ...
],
'PendingModifiedValues' => [
'AllocatedStorage' => <integer>,
'BackupRetentionPeriod' => <integer>,
'CaCertificateIdentifier' => '<string>',
'DbInstanceClass' => '<string>',
'DbInstanceIdentifier' => '<string>',
'DbSubnetGroupName' => '<string>',
'EngineVersion' => '<string>',
'Iops' => <integer>,
'LicenseModel' => '<string>',
'MasterUserPassword' => '<string>',
'MultiAZ' => true || false,
'PendingCloudWatchLogsExports' => [
'LogTypesToDisable' => ['<string>', ...],
'LogTypesToEnable' => ['<string>', ...],
],
'Port' => <integer>,
'ProcessorFeatures' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'StorageType' => '<string>',
],
'PerformanceInsightsEnabled' => true || false,
'PerformanceInsightsKmsKeyId' => '<string>',
'PerformanceInsightsRetentionPeriod' => <integer>,
'PreferredBackupWindow' => '<string>',
'PreferredMaintenanceWindow' => '<string>',
'ProcessorFeatures' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'PromotionTier' => <integer>,
'PubliclyAccessible' => true || false,
'ReadReplicaDBClusterIdentifiers' => ['<string>', ...],
'ReadReplicaDBInstanceIdentifiers' => ['<string>', ...],
'ReadReplicaSourceDBInstanceIdentifier' => '<string>',
'SecondaryAvailabilityZone' => '<string>',
'StatusInfos' => [
[
'Message' => '<string>',
'Normal' => true || false,
'Status' => '<string>',
'StatusType' => '<string>',
],
// ...
],
'StorageEncrypted' => true || false,
'StorageType' => '<string>',
'TdeCredentialArn' => '<string>',
'Timezone' => '<string>',
'VpcSecurityGroups' => [
[
'Status' => '<string>',
'VpcSecurityGroupId' => '<string>',
],
// ...
],
],
'AwsRdsDbSnapshot' => [
'AllocatedStorage' => <integer>,
'AvailabilityZone' => '<string>',
'DbInstanceIdentifier' => '<string>',
'DbSnapshotIdentifier' => '<string>',
'DbiResourceId' => '<string>',
'Encrypted' => true || false,
'Engine' => '<string>',
'EngineVersion' => '<string>',
'IamDatabaseAuthenticationEnabled' => true || false,
'InstanceCreateTime' => '<string>',
'Iops' => <integer>,
'KmsKeyId' => '<string>',
'LicenseModel' => '<string>',
'MasterUsername' => '<string>',
'OptionGroupName' => '<string>',
'PercentProgress' => <integer>,
'Port' => <integer>,
'ProcessorFeatures' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'SnapshotCreateTime' => '<string>',
'SnapshotType' => '<string>',
'SourceDbSnapshotIdentifier' => '<string>',
'SourceRegion' => '<string>',
'Status' => '<string>',
'StorageType' => '<string>',
'TdeCredentialArn' => '<string>',
'Timezone' => '<string>',
'VpcId' => '<string>',
],
'AwsRdsEventSubscription' => [
'CustSubscriptionId' => '<string>',
'CustomerAwsId' => '<string>',
'Enabled' => true || false,
'EventCategoriesList' => ['<string>', ...],
'EventSubscriptionArn' => '<string>',
'SnsTopicArn' => '<string>',
'SourceIdsList' => ['<string>', ...],
'SourceType' => '<string>',
'Status' => '<string>',
'SubscriptionCreationTime' => '<string>',
],
'AwsRedshiftCluster' => [
'AllowVersionUpgrade' => true || false,
'AutomatedSnapshotRetentionPeriod' => <integer>,
'AvailabilityZone' => '<string>',
'ClusterAvailabilityStatus' => '<string>',
'ClusterCreateTime' => '<string>',
'ClusterIdentifier' => '<string>',
'ClusterNodes' => [
[
'NodeRole' => '<string>',
'PrivateIpAddress' => '<string>',
'PublicIpAddress' => '<string>',
],
// ...
],
'ClusterParameterGroups' => [
[
'ClusterParameterStatusList' => [
[
'ParameterApplyErrorDescription' => '<string>',
'ParameterApplyStatus' => '<string>',
'ParameterName' => '<string>',
],
// ...
],
'ParameterApplyStatus' => '<string>',
'ParameterGroupName' => '<string>',
],
// ...
],
'ClusterPublicKey' => '<string>',
'ClusterRevisionNumber' => '<string>',
'ClusterSecurityGroups' => [
[
'ClusterSecurityGroupName' => '<string>',
'Status' => '<string>',
],
// ...
],
'ClusterSnapshotCopyStatus' => [
'DestinationRegion' => '<string>',
'ManualSnapshotRetentionPeriod' => <integer>,
'RetentionPeriod' => <integer>,
'SnapshotCopyGrantName' => '<string>',
],
'ClusterStatus' => '<string>',
'ClusterSubnetGroupName' => '<string>',
'ClusterVersion' => '<string>',
'DBName' => '<string>',
'DeferredMaintenanceWindows' => [
[
'DeferMaintenanceEndTime' => '<string>',
'DeferMaintenanceIdentifier' => '<string>',
'DeferMaintenanceStartTime' => '<string>',
],
// ...
],
'ElasticIpStatus' => [
'ElasticIp' => '<string>',
'Status' => '<string>',
],
'ElasticResizeNumberOfNodeOptions' => '<string>',
'Encrypted' => true || false,
'Endpoint' => [
'Address' => '<string>',
'Port' => <integer>,
],
'EnhancedVpcRouting' => true || false,
'ExpectedNextSnapshotScheduleTime' => '<string>',
'ExpectedNextSnapshotScheduleTimeStatus' => '<string>',
'HsmStatus' => [
'HsmClientCertificateIdentifier' => '<string>',
'HsmConfigurationIdentifier' => '<string>',
'Status' => '<string>',
],
'IamRoles' => [
[
'ApplyStatus' => '<string>',
'IamRoleArn' => '<string>',
],
// ...
],
'KmsKeyId' => '<string>',
'MaintenanceTrackName' => '<string>',
'ManualSnapshotRetentionPeriod' => <integer>,
'MasterUsername' => '<string>',
'NextMaintenanceWindowStartTime' => '<string>',
'NodeType' => '<string>',
'NumberOfNodes' => <integer>,
'PendingActions' => ['<string>', ...],
'PendingModifiedValues' => [
'AutomatedSnapshotRetentionPeriod' => <integer>,
'ClusterIdentifier' => '<string>',
'ClusterType' => '<string>',
'ClusterVersion' => '<string>',
'EncryptionType' => '<string>',
'EnhancedVpcRouting' => true || false,
'MaintenanceTrackName' => '<string>',
'MasterUserPassword' => '<string>',
'NodeType' => '<string>',
'NumberOfNodes' => <integer>,
'PubliclyAccessible' => true || false,
],
'PreferredMaintenanceWindow' => '<string>',
'PubliclyAccessible' => true || false,
'ResizeInfo' => [
'AllowCancelResize' => true || false,
'ResizeType' => '<string>',
],
'RestoreStatus' => [
'CurrentRestoreRateInMegaBytesPerSecond' => <float>,
'ElapsedTimeInSeconds' => <integer>,
'EstimatedTimeToCompletionInSeconds' => <integer>,
'ProgressInMegaBytes' => <integer>,
'SnapshotSizeInMegaBytes' => <integer>,
'Status' => '<string>',
],
'SnapshotScheduleIdentifier' => '<string>',
'SnapshotScheduleState' => '<string>',
'VpcId' => '<string>',
'VpcSecurityGroups' => [
[
'Status' => '<string>',
'VpcSecurityGroupId' => '<string>',
],
// ...
],
],
'AwsS3AccountPublicAccessBlock' => [
'BlockPublicAcls' => true || false,
'BlockPublicPolicy' => true || false,
'IgnorePublicAcls' => true || false,
'RestrictPublicBuckets' => true || false,
],
'AwsS3Bucket' => [
'BucketLifecycleConfiguration' => [
'Rules' => [
[
'AbortIncompleteMultipartUpload' => [
'DaysAfterInitiation' => <integer>,
],
'ExpirationDate' => '<string>',
'ExpirationInDays' => <integer>,
'ExpiredObjectDeleteMarker' => true || false,
'Filter' => [
'Predicate' => [
'Operands' => [
[
'Prefix' => '<string>',
'Tag' => [
'Key' => '<string>',
'Value' => '<string>',
],
'Type' => '<string>',
],
// ...
],
'Prefix' => '<string>',
'Tag' => [
'Key' => '<string>',
'Value' => '<string>',
],
'Type' => '<string>',
],
],
'ID' => '<string>',
'NoncurrentVersionExpirationInDays' => <integer>,
'NoncurrentVersionTransitions' => [
[
'Days' => <integer>,
'StorageClass' => '<string>',
],
// ...
],
'Prefix' => '<string>',
'Status' => '<string>',
'Transitions' => [
[
'Date' => '<string>',
'Days' => <integer>,
'StorageClass' => '<string>',
],
// ...
],
],
// ...
],
],
'CreatedAt' => '<string>',
'OwnerId' => '<string>',
'OwnerName' => '<string>',
'PublicAccessBlockConfiguration' => [
'BlockPublicAcls' => true || false,
'BlockPublicPolicy' => true || false,
'IgnorePublicAcls' => true || false,
'RestrictPublicBuckets' => true || false,
],
'ServerSideEncryptionConfiguration' => [
'Rules' => [
[
'ApplyServerSideEncryptionByDefault' => [
'KMSMasterKeyID' => '<string>',
'SSEAlgorithm' => '<string>',
],
],
// ...
],
],
],
'AwsS3Object' => [
'ContentType' => '<string>',
'ETag' => '<string>',
'LastModified' => '<string>',
'SSEKMSKeyId' => '<string>',
'ServerSideEncryption' => '<string>',
'VersionId' => '<string>',
],
'AwsSecretsManagerSecret' => [
'Deleted' => true || false,
'Description' => '<string>',
'KmsKeyId' => '<string>',
'Name' => '<string>',
'RotationEnabled' => true || false,
'RotationLambdaArn' => '<string>',
'RotationOccurredWithinFrequency' => true || false,
'RotationRules' => [
'AutomaticallyAfterDays' => <integer>,
],
],
'AwsSnsTopic' => [
'KmsMasterKeyId' => '<string>',
'Owner' => '<string>',
'Subscription' => [
[
'Endpoint' => '<string>',
'Protocol' => '<string>',
],
// ...
],
'TopicName' => '<string>',
],
'AwsSqsQueue' => [
'DeadLetterTargetArn' => '<string>',
'KmsDataKeyReusePeriodSeconds' => <integer>,
'KmsMasterKeyId' => '<string>',
'QueueName' => '<string>',
],
'AwsSsmPatchCompliance' => [
'Patch' => [
'ComplianceSummary' => [
'ComplianceType' => '<string>',
'CompliantCriticalCount' => <integer>,
'CompliantHighCount' => <integer>,
'CompliantInformationalCount' => <integer>,
'CompliantLowCount' => <integer>,
'CompliantMediumCount' => <integer>,
'CompliantUnspecifiedCount' => <integer>,
'ExecutionType' => '<string>',
'NonCompliantCriticalCount' => <integer>,
'NonCompliantHighCount' => <integer>,
'NonCompliantInformationalCount' => <integer>,
'NonCompliantLowCount' => <integer>,
'NonCompliantMediumCount' => <integer>,
'NonCompliantUnspecifiedCount' => <integer>,
'OverallSeverity' => '<string>',
'PatchBaselineId' => '<string>',
'PatchGroup' => '<string>',
'Status' => '<string>',
],
],
],
'AwsWafWebAcl' => [
'DefaultAction' => '<string>',
'Name' => '<string>',
'Rules' => [
[
'Action' => [
'Type' => '<string>',
],
'ExcludedRules' => [
[
'RuleId' => '<string>',
],
// ...
],
'OverrideAction' => [
'Type' => '<string>',
],
'Priority' => <integer>,
'RuleId' => '<string>',
'Type' => '<string>',
],
// ...
],
'WebAclId' => '<string>',
],
'Container' => [
'ImageId' => '<string>',
'ImageName' => '<string>',
'LaunchedAt' => '<string>',
'Name' => '<string>',
],
'Other' => ['<string>', ...],
],
'Id' => '<string>', // REQUIRED
'Partition' => 'aws|aws-cn|aws-us-gov',
'Region' => '<string>',
'ResourceRole' => '<string>',
'Tags' => ['<string>', ...],
'Type' => '<string>', // REQUIRED
],
// ...
],
'SchemaVersion' => '<string>', // REQUIRED
'Severity' => [
'Label' => 'INFORMATIONAL|LOW|MEDIUM|HIGH|CRITICAL',
'Normalized' => <integer>,
'Original' => '<string>',
'Product' => <float>,
],
'SourceUrl' => '<string>',
'ThreatIntelIndicators' => [
[
'Category' => 'BACKDOOR|CARD_STEALER|COMMAND_AND_CONTROL|DROP_SITE|EXPLOIT_SITE|KEYLOGGER',
'LastObservedAt' => '<string>',
'Source' => '<string>',
'SourceUrl' => '<string>',
'Type' => 'DOMAIN|EMAIL_ADDRESS|HASH_MD5|HASH_SHA1|HASH_SHA256|HASH_SHA512|IPV4_ADDRESS|IPV6_ADDRESS|MUTEX|PROCESS|URL',
'Value' => '<string>',
],
// ...
],
'Title' => '<string>', // REQUIRED
'Types' => ['<string>', ...],
'UpdatedAt' => '<string>', // REQUIRED
'UserDefinedFields' => ['<string>', ...],
'VerificationState' => 'UNKNOWN|TRUE_POSITIVE|FALSE_POSITIVE|BENIGN_POSITIVE',
'Vulnerabilities' => [
[
'Cvss' => [
[
'BaseScore' => <float>,
'BaseVector' => '<string>',
'Version' => '<string>',
],
// ...
],
'Id' => '<string>', // REQUIRED
'ReferenceUrls' => ['<string>', ...],
'RelatedVulnerabilities' => ['<string>', ...],
'Vendor' => [
'Name' => '<string>', // REQUIRED
'Url' => '<string>',
'VendorCreatedAt' => '<string>',
'VendorSeverity' => '<string>',
'VendorUpdatedAt' => '<string>',
],
'VulnerablePackages' => [
[
'Architecture' => '<string>',
'Epoch' => '<string>',
'Name' => '<string>',
'Release' => '<string>',
'Version' => '<string>',
],
// ...
],
],
// ...
],
'Workflow' => [
'Status' => 'NEW|NOTIFIED|RESOLVED|SUPPRESSED',
],
'WorkflowState' => 'NEW|ASSIGNED|IN_PROGRESS|DEFERRED|RESOLVED',
],
// ...
],
]);
Parameter Details
Members
- Findings
-
- Required: Yes
- Type: Array of AwsSecurityFinding structures
A list of findings to import. To successfully import a finding, it must follow the Amazon Web Services Security Finding Format. Maximum of 100 findings per request.
Result Syntax
[
'FailedCount' => <integer>,
'FailedFindings' => [
[
'ErrorCode' => '<string>',
'ErrorMessage' => '<string>',
'Id' => '<string>',
],
// ...
],
'SuccessCount' => <integer>,
]
Result Details
Members
- FailedCount
-
- Required: Yes
- Type: int
The number of findings that failed to import.
- FailedFindings
-
- Type: Array of ImportFindingsError structures
The list of findings that failed to import.
- SuccessCount
-
- Required: Yes
- Type: int
The number of findings that were successfully imported.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
BatchUpdateFindings
$result = $client->batchUpdateFindings([/* ... */]); $promise = $client->batchUpdateFindingsAsync([/* ... */]);
Used by Security Hub customers to update information about their investigation into a finding. Requested by administrator accounts or member accounts. Administrator accounts can update findings for their account and their member accounts. Member accounts can update findings for their account.
Updates from BatchUpdateFindings do not affect the value of UpdatedAt for a finding.
Administrator and member accounts can use BatchUpdateFindings to update the following finding fields and objects.
-
Confidence -
Criticality -
Note -
RelatedFindings -
Severity -
Types -
UserDefinedFields -
VerificationState -
Workflow
You can configure IAM policies to restrict access to fields and field values. For example, you might not want member accounts to be able to suppress findings or change the finding severity. See Configuring access to BatchUpdateFindings in the Security Hub User Guide.
Parameter Syntax
$result = $client->batchUpdateFindings([
'Confidence' => <integer>,
'Criticality' => <integer>,
'FindingIdentifiers' => [ // REQUIRED
[
'Id' => '<string>', // REQUIRED
'ProductArn' => '<string>', // REQUIRED
],
// ...
],
'Note' => [
'Text' => '<string>', // REQUIRED
'UpdatedBy' => '<string>', // REQUIRED
],
'RelatedFindings' => [
[
'Id' => '<string>', // REQUIRED
'ProductArn' => '<string>', // REQUIRED
],
// ...
],
'Severity' => [
'Label' => 'INFORMATIONAL|LOW|MEDIUM|HIGH|CRITICAL',
'Normalized' => <integer>,
'Product' => <float>,
],
'Types' => ['<string>', ...],
'UserDefinedFields' => ['<string>', ...],
'VerificationState' => 'UNKNOWN|TRUE_POSITIVE|FALSE_POSITIVE|BENIGN_POSITIVE',
'Workflow' => [
'Status' => 'NEW|NOTIFIED|RESOLVED|SUPPRESSED',
],
]);
Parameter Details
Members
- Confidence
-
- Type: int
The updated value for the finding confidence. Confidence is defined as the likelihood that a finding accurately identifies the behavior or issue that it was intended to identify.
Confidence is scored on a 0-100 basis using a ratio scale, where 0 means zero percent confidence and 100 means 100 percent confidence.
- Criticality
-
- Type: int
The updated value for the level of importance assigned to the resources associated with the findings.
A score of 0 means that the underlying resources have no criticality, and a score of 100 is reserved for the most critical resources.
- FindingIdentifiers
-
- Required: Yes
- Type: Array of AwsSecurityFindingIdentifier structures
The list of findings to update.
BatchUpdateFindingscan be used to update up to 100 findings at a time.For each finding, the list provides the finding identifier and the ARN of the finding provider.
- Note
-
- Type: NoteUpdate structure
The updated note.
- RelatedFindings
-
- Type: Array of RelatedFinding structures
A list of findings that are related to the updated findings.
- Severity
-
- Type: SeverityUpdate structure
Used to update the finding severity.
- Types
-
- Type: Array of strings
One or more finding types in the format of namespace/category/classifier that classify a finding.
Valid namespace values are as follows.
-
Software and Configuration Checks
-
TTPs
-
Effects
-
Unusual Behaviors
-
Sensitive Data Identifications
- UserDefinedFields
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A list of name/value string pairs associated with the finding. These are custom, user-defined fields added to a finding.
- VerificationState
-
- Type: string
Indicates the veracity of a finding.
The available values for
VerificationStateare as follows.-
UNKNOWN– The default disposition of a security finding -
TRUE_POSITIVE– The security finding is confirmed -
FALSE_POSITIVE– The security finding was determined to be a false alarm -
BENIGN_POSITIVE– A special case ofTRUE_POSITIVEwhere the finding doesn't pose any threat, is expected, or both
- Workflow
-
- Type: WorkflowUpdate structure
Used to update the workflow status of a finding.
The workflow status indicates the progress of the investigation into the finding.
Result Syntax
[
'ProcessedFindings' => [
[
'Id' => '<string>',
'ProductArn' => '<string>',
],
// ...
],
'UnprocessedFindings' => [
[
'ErrorCode' => '<string>',
'ErrorMessage' => '<string>',
'FindingIdentifier' => [
'Id' => '<string>',
'ProductArn' => '<string>',
],
],
// ...
],
]
Result Details
Members
- ProcessedFindings
-
- Required: Yes
- Type: Array of AwsSecurityFindingIdentifier structures
The list of findings that were updated successfully.
- UnprocessedFindings
-
- Required: Yes
- Type: Array of BatchUpdateFindingsUnprocessedFinding structures
The list of findings that were not updated.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
CreateActionTarget
$result = $client->createActionTarget([/* ... */]); $promise = $client->createActionTargetAsync([/* ... */]);
Creates a custom action target in Security Hub.
You can use custom actions on findings and insights in Security Hub to trigger target actions in Amazon CloudWatch Events.
Parameter Syntax
$result = $client->createActionTarget([
'Description' => '<string>', // REQUIRED
'Id' => '<string>', // REQUIRED
'Name' => '<string>', // REQUIRED
]);
Parameter Details
Members
- Description
-
- Required: Yes
- Type: string
The description for the custom action target.
- Id
-
- Required: Yes
- Type: string
The ID for the custom action target. Can contain up to 20 alphanumeric characters.
- Name
-
- Required: Yes
- Type: string
The name of the custom action target. Can contain up to 20 characters.
Result Syntax
[
'ActionTargetArn' => '<string>',
]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The resource specified in the request conflicts with an existing resource.
CreateInsight
$result = $client->createInsight([/* ... */]); $promise = $client->createInsightAsync([/* ... */]);
Creates a custom insight in Security Hub. An insight is a consolidation of findings that relate to a security issue that requires attention or remediation.
To group the related findings in the insight, use the GroupByAttribute.
Parameter Syntax
$result = $client->createInsight([
'Filters' => [ // REQUIRED
'AwsAccountId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'CompanyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ComplianceStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Confidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'CreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'Criticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'Description' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsConfidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsCriticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsRelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsRelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityOriginal' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsTypes' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FirstObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'GeneratorId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Id' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Keyword' => [
[
'Value' => '<string>',
],
// ...
],
'LastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'MalwareName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwarePath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationPort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NetworkDirection' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkProtocol' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceMac' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourcePort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NoteText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NoteUpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'NoteUpdatedBy' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProcessName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessParentPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessPath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessTerminatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProductFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ProductName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecommendationText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecordState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIamInstanceProfileArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV4Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV6Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceKeyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceSubnetId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceVpcId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyCreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyPrincipalName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamUserUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceContainerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceDetailsOther' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourcePartition' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceRegion' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceTags' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityNormalized' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SeverityProduct' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorCategory' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorLastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSource' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorValue' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Title' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Type' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'UpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'UserDefinedFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'VerificationState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
],
'GroupByAttribute' => '<string>', // REQUIRED
'Name' => '<string>', // REQUIRED
]);
Parameter Details
Members
- Filters
-
- Required: Yes
- Type: AwsSecurityFindingFilters structure
One or more attributes used to filter the findings included in the insight. The insight only includes findings that match the criteria defined in the filters.
- GroupByAttribute
-
- Required: Yes
- Type: string
The attribute used to group the findings for the insight. The grouping attribute identifies the type of item that the insight applies to. For example, if an insight is grouped by resource identifier, then the insight produces a list of resource identifiers.
- Name
-
- Required: Yes
- Type: string
The name of the custom insight to create.
Result Syntax
[
'InsightArn' => '<string>',
]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The resource specified in the request conflicts with an existing resource.
CreateMembers
$result = $client->createMembers([/* ... */]); $promise = $client->createMembersAsync([/* ... */]);
Creates a member association in Security Hub between the specified accounts and the account used to make the request, which is the administrator account. If you are integrated with Organizations, then the administrator account is designated by the organization management account.
CreateMembers is always used to add accounts that are not organization members.
For accounts that are managed using Organizations, CreateMembers is only used in the following cases:
-
Security Hub is not configured to automatically add new organization accounts.
-
The account was disassociated or deleted in Security Hub.
This action can only be used by an account that has Security Hub enabled. To enable Security Hub, you can use the EnableSecurityHub operation.
For accounts that are not organization members, you create the account association and then send an invitation to the member account. To send the invitation, you use the InviteMembers operation. If the account owner accepts the invitation, the account becomes a member account in Security Hub.
Accounts that are managed using Organizations do not receive an invitation. They automatically become a member account in Security Hub, and Security Hub is automatically enabled for those accounts. Note that Security Hub cannot be enabled automatically for the organization management account. The organization management account must enable Security Hub before the administrator account enables it as a member account.
A permissions policy is added that permits the administrator account to view the findings generated in the member account. When Security Hub is enabled in a member account, the member account findings are also visible to the administrator account.
To remove the association between the administrator and member accounts, use the DisassociateFromMasterAccount or DisassociateMembers operation.
Parameter Syntax
$result = $client->createMembers([
'AccountDetails' => [ // REQUIRED
[
'AccountId' => '<string>', // REQUIRED
'Email' => '<string>',
],
// ...
],
]);
Parameter Details
Members
- AccountDetails
-
- Required: Yes
- Type: Array of AccountDetails structures
The list of accounts to associate with the Security Hub administrator account. For each account, the list includes the account ID and optionally the email address.
Result Syntax
[
'UnprocessedAccounts' => [
[
'AccountId' => '<string>',
'ProcessingResult' => '<string>',
],
// ...
],
]
Result Details
Members
- UnprocessedAccounts
-
- Type: Array of Result structures
The list of Amazon Web Services accounts that were not processed. For each account, the list includes the account ID and the email address.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The resource specified in the request conflicts with an existing resource.
DeclineInvitations
$result = $client->declineInvitations([/* ... */]); $promise = $client->declineInvitationsAsync([/* ... */]);
Declines invitations to become a member account.
This operation is only used by accounts that are not part of an organization. Organization accounts do not receive invitations.
Parameter Syntax
$result = $client->declineInvitations([
'AccountIds' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'UnprocessedAccounts' => [
[
'AccountId' => '<string>',
'ProcessingResult' => '<string>',
],
// ...
],
]
Result Details
Members
- UnprocessedAccounts
-
- Type: Array of Result structures
The list of Amazon Web Services accounts that were not processed. For each account, the list includes the account ID and the email address.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
DeleteActionTarget
$result = $client->deleteActionTarget([/* ... */]); $promise = $client->deleteActionTargetAsync([/* ... */]);
Deletes a custom action target from Security Hub.
Deleting a custom action target does not affect any findings or insights that were already sent to Amazon CloudWatch Events using the custom action.
Parameter Syntax
$result = $client->deleteActionTarget([
'ActionTargetArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'ActionTargetArn' => '<string>',
]
Result Details
Members
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
DeleteInsight
$result = $client->deleteInsight([/* ... */]); $promise = $client->deleteInsightAsync([/* ... */]);
Deletes the insight specified by the InsightArn.
Parameter Syntax
$result = $client->deleteInsight([
'InsightArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'InsightArn' => '<string>',
]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
DeleteInvitations
$result = $client->deleteInvitations([/* ... */]); $promise = $client->deleteInvitationsAsync([/* ... */]);
Deletes invitations received by the Amazon Web Services account to become a member account.
This operation is only used by accounts that are not part of an organization. Organization accounts do not receive invitations.
Parameter Syntax
$result = $client->deleteInvitations([
'AccountIds' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'UnprocessedAccounts' => [
[
'AccountId' => '<string>',
'ProcessingResult' => '<string>',
],
// ...
],
]
Result Details
Members
- UnprocessedAccounts
-
- Type: Array of Result structures
The list of Amazon Web Services accounts for which the invitations were not deleted. For each account, the list includes the account ID and the email address.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
DeleteMembers
$result = $client->deleteMembers([/* ... */]); $promise = $client->deleteMembersAsync([/* ... */]);
Deletes the specified member accounts from Security Hub.
Can be used to delete member accounts that belong to an organization as well as member accounts that were invited manually.
Parameter Syntax
$result = $client->deleteMembers([
'AccountIds' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'UnprocessedAccounts' => [
[
'AccountId' => '<string>',
'ProcessingResult' => '<string>',
],
// ...
],
]
Result Details
Members
- UnprocessedAccounts
-
- Type: Array of Result structures
The list of Amazon Web Services accounts that were not deleted. For each account, the list includes the account ID and the email address.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
DescribeActionTargets
$result = $client->describeActionTargets([/* ... */]); $promise = $client->describeActionTargetsAsync([/* ... */]);
Returns a list of the custom action targets in Security Hub in your account.
Parameter Syntax
$result = $client->describeActionTargets([
'ActionTargetArns' => ['<string>', ...],
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
- ActionTargetArns
-
- Type: Array of strings
A list of custom action target ARNs for the custom action targets to retrieve.
- MaxResults
-
- Type: int
The maximum number of results to return.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
DescribeActionTargetsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
Result Syntax
[
'ActionTargets' => [
[
'ActionTargetArn' => '<string>',
'Description' => '<string>',
'Name' => '<string>',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- ActionTargets
-
- Required: Yes
- Type: Array of ActionTarget structures
A list of
ActionTargetobjects. Each object includes theActionTargetArn,Description, andNameof a custom action target available in Security Hub. - NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
DescribeHub
$result = $client->describeHub([/* ... */]); $promise = $client->describeHubAsync([/* ... */]);
Returns details about the Hub resource in your account, including the HubArn and the time when you enabled Security Hub.
Parameter Syntax
$result = $client->describeHub([
'HubArn' => '<string>',
]);
Parameter Details
Result Syntax
[
'AutoEnableControls' => true || false,
'HubArn' => '<string>',
'SubscribedAt' => '<string>',
]
Result Details
Members
- AutoEnableControls
-
- Type: boolean
Whether to automatically enable new controls when they are added to standards that are enabled.
If set to
true, then new controls for enabled standards are enabled automatically. If set tofalse, then new controls are not enabled. - HubArn
-
- Type: string
The ARN of the Hub resource that was retrieved.
- SubscribedAt
-
- Type: string
The date and time when Security Hub was enabled in the account.
Errors
-
Internal server error.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because we can't find the specified resource.
DescribeOrganizationConfiguration
$result = $client->describeOrganizationConfiguration([/* ... */]); $promise = $client->describeOrganizationConfigurationAsync([/* ... */]);
Returns information about the Organizations configuration for Security Hub. Can only be called from a Security Hub administrator account.
Parameter Syntax
$result = $client->describeOrganizationConfiguration([ ]);
Parameter Details
Members
Result Syntax
[
'AutoEnable' => true || false,
'MemberAccountLimitReached' => true || false,
]
Result Details
Members
- AutoEnable
-
- Type: boolean
Whether to automatically enable Security Hub for new accounts in the organization.
If set to
true, then Security Hub is enabled for new accounts. If set to false, then new accounts are not added automatically. - MemberAccountLimitReached
-
- Type: boolean
Whether the maximum number of allowed member accounts are already associated with the Security Hub administrator account.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
DescribeProducts
$result = $client->describeProducts([/* ... */]); $promise = $client->describeProductsAsync([/* ... */]);
Returns information about product integrations in Security Hub.
You can optionally provide an integration ARN. If you provide an integration ARN, then the results only include that integration.
If you do not provide an integration ARN, then the results include all of the available product integrations.
Parameter Syntax
$result = $client->describeProducts([
'MaxResults' => <integer>,
'NextToken' => '<string>',
'ProductArn' => '<string>',
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
DescribeProductsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
- ProductArn
-
- Type: string
The ARN of the integration to return.
Result Syntax
[
'NextToken' => '<string>',
'Products' => [
[
'ActivationUrl' => '<string>',
'Categories' => ['<string>', ...],
'CompanyName' => '<string>',
'Description' => '<string>',
'IntegrationTypes' => ['<string>', ...],
'MarketplaceUrl' => '<string>',
'ProductArn' => '<string>',
'ProductName' => '<string>',
'ProductSubscriptionResourcePolicy' => '<string>',
],
// ...
],
]
Result Details
Members
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
- Products
-
- Required: Yes
- Type: Array of Product structures
A list of products, including details for each product.
Errors
-
Internal server error.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
DescribeStandards
$result = $client->describeStandards([/* ... */]); $promise = $client->describeStandardsAsync([/* ... */]);
Returns a list of the available standards in Security Hub.
For each standard, the results include the standard ARN, the name, and a description.
Parameter Syntax
$result = $client->describeStandards([
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of standards to return.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
DescribeStandardsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
Result Syntax
[
'NextToken' => '<string>',
'Standards' => [
[
'Description' => '<string>',
'EnabledByDefault' => true || false,
'Name' => '<string>',
'StandardsArn' => '<string>',
],
// ...
],
]
Result Details
Members
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
- Standards
-
- Type: Array of Standard structures
A list of available standards.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
DescribeStandardsControls
$result = $client->describeStandardsControls([/* ... */]); $promise = $client->describeStandardsControlsAsync([/* ... */]);
Returns a list of security standards controls.
For each control, the results include information about whether it is currently enabled, the severity, and a link to remediation information.
Parameter Syntax
$result = $client->describeStandardsControls([
'MaxResults' => <integer>,
'NextToken' => '<string>',
'StandardsSubscriptionArn' => '<string>', // REQUIRED
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of security standard controls to return.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
DescribeStandardsControlsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
- StandardsSubscriptionArn
-
- Required: Yes
- Type: string
The ARN of a resource that represents your subscription to a supported standard. To get the subscription ARNs of the standards you have enabled, use the
GetEnabledStandardsoperation.
Result Syntax
[
'Controls' => [
[
'ControlId' => '<string>',
'ControlStatus' => 'ENABLED|DISABLED',
'ControlStatusUpdatedAt' => <DateTime>,
'Description' => '<string>',
'DisabledReason' => '<string>',
'RelatedRequirements' => ['<string>', ...],
'RemediationUrl' => '<string>',
'SeverityRating' => 'LOW|MEDIUM|HIGH|CRITICAL',
'StandardsControlArn' => '<string>',
'Title' => '<string>',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- Controls
-
- Type: Array of StandardsControl structures
A list of security standards controls.
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
DisableImportFindingsForProduct
$result = $client->disableImportFindingsForProduct([/* ... */]); $promise = $client->disableImportFindingsForProductAsync([/* ... */]);
Disables the integration of the specified product with Security Hub. After the integration is disabled, findings from that product are no longer sent to Security Hub.
Parameter Syntax
$result = $client->disableImportFindingsForProduct([
'ProductSubscriptionArn' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because we can't find the specified resource.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
DisableOrganizationAdminAccount
$result = $client->disableOrganizationAdminAccount([/* ... */]); $promise = $client->disableOrganizationAdminAccountAsync([/* ... */]);
Disables a Security Hub administrator account. Can only be called by the organization management account.
Parameter Syntax
$result = $client->disableOrganizationAdminAccount([
'AdminAccountId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
DisableSecurityHub
$result = $client->disableSecurityHub([/* ... */]); $promise = $client->disableSecurityHubAsync([/* ... */]);
Disables Security Hub in your account only in the current Region. To disable Security Hub in all Regions, you must submit one request per Region where you have enabled Security Hub.
When you disable Security Hub for an administrator account, it doesn't disable Security Hub for any associated member accounts.
When you disable Security Hub, your existing findings and insights and any Security Hub configuration settings are deleted after 90 days and cannot be recovered. Any standards that were enabled are disabled, and your administrator and member account associations are removed.
If you want to save your existing findings, you must export them before you disable Security Hub.
Parameter Syntax
$result = $client->disableSecurityHub([ ]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
DisassociateFromAdministratorAccount
$result = $client->disassociateFromAdministratorAccount([/* ... */]); $promise = $client->disassociateFromAdministratorAccountAsync([/* ... */]);
Disassociates the current Security Hub member account from the associated administrator account.
This operation is only used by accounts that are not part of an organization. For organization accounts, only the administrator account can disassociate a member account.
Parameter Syntax
$result = $client->disassociateFromAdministratorAccount([ ]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
DisassociateFromMasterAccount
$result = $client->disassociateFromMasterAccount([/* ... */]); $promise = $client->disassociateFromMasterAccountAsync([/* ... */]);
This method is deprecated. Instead, use DisassociateFromAdministratorAccount.
The Security Hub console continues to use DisassociateFromMasterAccount. It will eventually change to use DisassociateFromAdministratorAccount. Any IAM policies that specifically control access to this function must continue to use DisassociateFromMasterAccount. You should also add DisassociateFromAdministratorAccount to your policies to ensure that the correct permissions are in place after the console begins to use DisassociateFromAdministratorAccount.
Disassociates the current Security Hub member account from the associated administrator account.
This operation is only used by accounts that are not part of an organization. For organization accounts, only the administrator account can disassociate a member account.
Parameter Syntax
$result = $client->disassociateFromMasterAccount([ ]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
DisassociateMembers
$result = $client->disassociateMembers([/* ... */]); $promise = $client->disassociateMembersAsync([/* ... */]);
Disassociates the specified member accounts from the associated administrator account.
Can be used to disassociate both accounts that are managed using Organizations and accounts that were invited manually.
Parameter Syntax
$result = $client->disassociateMembers([
'AccountIds' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
EnableImportFindingsForProduct
$result = $client->enableImportFindingsForProduct([/* ... */]); $promise = $client->enableImportFindingsForProductAsync([/* ... */]);
Enables the integration of a partner product with Security Hub. Integrated products send findings to Security Hub.
When you enable a product integration, a permissions policy that grants permission for the product to send findings to Security Hub is applied.
Parameter Syntax
$result = $client->enableImportFindingsForProduct([
'ProductArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'ProductSubscriptionArn' => '<string>',
]
Result Details
Members
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The resource specified in the request conflicts with an existing resource.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
EnableOrganizationAdminAccount
$result = $client->enableOrganizationAdminAccount([/* ... */]); $promise = $client->enableOrganizationAdminAccountAsync([/* ... */]);
Designates the Security Hub administrator account for an organization. Can only be called by the organization management account.
Parameter Syntax
$result = $client->enableOrganizationAdminAccount([
'AdminAccountId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
EnableSecurityHub
$result = $client->enableSecurityHub([/* ... */]); $promise = $client->enableSecurityHubAsync([/* ... */]);
Enables Security Hub for your account in the current Region or the Region you specify in the request.
When you enable Security Hub, you grant to Security Hub the permissions necessary to gather findings from other services that are integrated with Security Hub.
When you use the EnableSecurityHub operation to enable Security Hub, you also automatically enable the following standards.
-
CIS Amazon Web Services Foundations
-
Amazon Web Services Foundational Security Best Practices
You do not enable the Payment Card Industry Data Security Standard (PCI DSS) standard.
To not enable the automatically enabled standards, set EnableDefaultStandards to false.
After you enable Security Hub, to enable a standard, use the BatchEnableStandards operation. To disable a standard, use the BatchDisableStandards operation.
To learn more, see the setup information in the Security Hub User Guide.
Parameter Syntax
$result = $client->enableSecurityHub([
'EnableDefaultStandards' => true || false,
'Tags' => ['<string>', ...],
]);
Parameter Details
Members
- EnableDefaultStandards
-
- Type: boolean
Whether to enable the security standards that Security Hub has designated as automatically enabled. If you do not provide a value for
EnableDefaultStandards, it is set totrue. To not enable the automatically enabled standards, setEnableDefaultStandardstofalse. - Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags to add to the hub resource when you enable Security Hub.
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The resource specified in the request conflicts with an existing resource.
-
You don't have permission to perform the action specified in the request.
GetAdministratorAccount
$result = $client->getAdministratorAccount([/* ... */]); $promise = $client->getAdministratorAccountAsync([/* ... */]);
Provides the details for the Security Hub administrator account for the current member account.
Can be used by both member accounts that are managed using Organizations and accounts that were invited manually.
Parameter Syntax
$result = $client->getAdministratorAccount([ ]);
Parameter Details
Members
Result Syntax
[
'Administrator' => [
'AccountId' => '<string>',
'InvitationId' => '<string>',
'InvitedAt' => <DateTime>,
'MemberStatus' => '<string>',
],
]
Result Details
Members
- Administrator
-
- Type: Invitation structure
Details about an invitation.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
GetEnabledStandards
$result = $client->getEnabledStandards([/* ... */]); $promise = $client->getEnabledStandardsAsync([/* ... */]);
Returns a list of the standards that are currently enabled.
Parameter Syntax
$result = $client->getEnabledStandards([
'MaxResults' => <integer>,
'NextToken' => '<string>',
'StandardsSubscriptionArns' => ['<string>', ...],
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in the response.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
GetEnabledStandardsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
- StandardsSubscriptionArns
-
- Type: Array of strings
The list of the standards subscription ARNs for the standards to retrieve.
Result Syntax
[
'NextToken' => '<string>',
'StandardsSubscriptions' => [
[
'StandardsArn' => '<string>',
'StandardsInput' => ['<string>', ...],
'StandardsStatus' => 'PENDING|READY|FAILED|DELETING|INCOMPLETE',
'StandardsSubscriptionArn' => '<string>',
],
// ...
],
]
Result Details
Members
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
- StandardsSubscriptions
-
- Type: Array of StandardsSubscription structures
The list of
StandardsSubscriptionsobjects that include information about the enabled standards.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
GetFindings
$result = $client->getFindings([/* ... */]); $promise = $client->getFindingsAsync([/* ... */]);
Returns a list of findings that match the specified criteria.
Parameter Syntax
$result = $client->getFindings([
'Filters' => [
'AwsAccountId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'CompanyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ComplianceStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Confidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'CreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'Criticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'Description' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsConfidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsCriticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsRelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsRelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityOriginal' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsTypes' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FirstObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'GeneratorId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Id' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Keyword' => [
[
'Value' => '<string>',
],
// ...
],
'LastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'MalwareName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwarePath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationPort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NetworkDirection' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkProtocol' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceMac' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourcePort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NoteText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NoteUpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'NoteUpdatedBy' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProcessName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessParentPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessPath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessTerminatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProductFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ProductName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecommendationText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecordState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIamInstanceProfileArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV4Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV6Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceKeyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceSubnetId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceVpcId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyCreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyPrincipalName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamUserUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceContainerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceDetailsOther' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourcePartition' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceRegion' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceTags' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityNormalized' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SeverityProduct' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorCategory' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorLastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSource' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorValue' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Title' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Type' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'UpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'UserDefinedFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'VerificationState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
],
'MaxResults' => <integer>,
'NextToken' => '<string>',
'SortCriteria' => [
[
'Field' => '<string>',
'SortOrder' => 'asc|desc',
],
// ...
],
]);
Parameter Details
Members
- Filters
-
- Type: AwsSecurityFindingFilters structure
The finding attributes used to define a condition to filter the returned findings.
You can filter by up to 10 finding attributes. For each attribute, you can provide up to 20 filter values.
Note that in the available filter fields,
WorkflowStateis deprecated. To search for a finding based on its workflow status, useWorkflowStatus. - MaxResults
-
- Type: int
The maximum number of findings to return.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
GetFindingsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
- SortCriteria
-
- Type: Array of SortCriterion structures
The finding attributes used to sort the list of returned findings.
Result Syntax
[
'Findings' => [
[
'Action' => [
'ActionType' => '<string>',
'AwsApiCallAction' => [
'AffectedResources' => ['<string>', ...],
'Api' => '<string>',
'CallerType' => '<string>',
'DomainDetails' => [
'Domain' => '<string>',
],
'FirstSeen' => '<string>',
'LastSeen' => '<string>',
'RemoteIpDetails' => [
'City' => [
'CityName' => '<string>',
],
'Country' => [
'CountryCode' => '<string>',
'CountryName' => '<string>',
],
'GeoLocation' => [
'Lat' => <float>,
'Lon' => <float>,
],
'IpAddressV4' => '<string>',
'Organization' => [
'Asn' => <integer>,
'AsnOrg' => '<string>',
'Isp' => '<string>',
'Org' => '<string>',
],
],
'ServiceName' => '<string>',
],
'DnsRequestAction' => [
'Blocked' => true || false,
'Domain' => '<string>',
'Protocol' => '<string>',
],
'NetworkConnectionAction' => [
'Blocked' => true || false,
'ConnectionDirection' => '<string>',
'LocalPortDetails' => [
'Port' => <integer>,
'PortName' => '<string>',
],
'Protocol' => '<string>',
'RemoteIpDetails' => [
'City' => [
'CityName' => '<string>',
],
'Country' => [
'CountryCode' => '<string>',
'CountryName' => '<string>',
],
'GeoLocation' => [
'Lat' => <float>,
'Lon' => <float>,
],
'IpAddressV4' => '<string>',
'Organization' => [
'Asn' => <integer>,
'AsnOrg' => '<string>',
'Isp' => '<string>',
'Org' => '<string>',
],
],
'RemotePortDetails' => [
'Port' => <integer>,
'PortName' => '<string>',
],
],
'PortProbeAction' => [
'Blocked' => true || false,
'PortProbeDetails' => [
[
'LocalIpDetails' => [
'IpAddressV4' => '<string>',
],
'LocalPortDetails' => [
'Port' => <integer>,
'PortName' => '<string>',
],
'RemoteIpDetails' => [
'City' => [
'CityName' => '<string>',
],
'Country' => [
'CountryCode' => '<string>',
'CountryName' => '<string>',
],
'GeoLocation' => [
'Lat' => <float>,
'Lon' => <float>,
],
'IpAddressV4' => '<string>',
'Organization' => [
'Asn' => <integer>,
'AsnOrg' => '<string>',
'Isp' => '<string>',
'Org' => '<string>',
],
],
],
// ...
],
],
],
'AwsAccountId' => '<string>',
'CompanyName' => '<string>',
'Compliance' => [
'RelatedRequirements' => ['<string>', ...],
'Status' => 'PASSED|WARNING|FAILED|NOT_AVAILABLE',
'StatusReasons' => [
[
'Description' => '<string>',
'ReasonCode' => '<string>',
],
// ...
],
],
'Confidence' => <integer>,
'CreatedAt' => '<string>',
'Criticality' => <integer>,
'Description' => '<string>',
'FindingProviderFields' => [
'Confidence' => <integer>,
'Criticality' => <integer>,
'RelatedFindings' => [
[
'Id' => '<string>',
'ProductArn' => '<string>',
],
// ...
],
'Severity' => [
'Label' => 'INFORMATIONAL|LOW|MEDIUM|HIGH|CRITICAL',
'Original' => '<string>',
],
'Types' => ['<string>', ...],
],
'FirstObservedAt' => '<string>',
'GeneratorId' => '<string>',
'Id' => '<string>',
'LastObservedAt' => '<string>',
'Malware' => [
[
'Name' => '<string>',
'Path' => '<string>',
'State' => 'OBSERVED|REMOVAL_FAILED|REMOVED',
'Type' => 'ADWARE|BLENDED_THREAT|BOTNET_AGENT|COIN_MINER|EXPLOIT_KIT|KEYLOGGER|MACRO|POTENTIALLY_UNWANTED|SPYWARE|RANSOMWARE|REMOTE_ACCESS|ROOTKIT|TROJAN|VIRUS|WORM',
],
// ...
],
'Network' => [
'DestinationDomain' => '<string>',
'DestinationIpV4' => '<string>',
'DestinationIpV6' => '<string>',
'DestinationPort' => <integer>,
'Direction' => 'IN|OUT',
'OpenPortRange' => [
'Begin' => <integer>,
'End' => <integer>,
],
'Protocol' => '<string>',
'SourceDomain' => '<string>',
'SourceIpV4' => '<string>',
'SourceIpV6' => '<string>',
'SourceMac' => '<string>',
'SourcePort' => <integer>,
],
'NetworkPath' => [
[
'ComponentId' => '<string>',
'ComponentType' => '<string>',
'Egress' => [
'Destination' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
'Protocol' => '<string>',
'Source' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
],
'Ingress' => [
'Destination' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
'Protocol' => '<string>',
'Source' => [
'Address' => ['<string>', ...],
'PortRanges' => [
[
'Begin' => <integer>,
'End' => <integer>,
],
// ...
],
],
],
],
// ...
],
'Note' => [
'Text' => '<string>',
'UpdatedAt' => '<string>',
'UpdatedBy' => '<string>',
],
'PatchSummary' => [
'FailedCount' => <integer>,
'Id' => '<string>',
'InstalledCount' => <integer>,
'InstalledOtherCount' => <integer>,
'InstalledPendingReboot' => <integer>,
'InstalledRejectedCount' => <integer>,
'MissingCount' => <integer>,
'Operation' => '<string>',
'OperationEndTime' => '<string>',
'OperationStartTime' => '<string>',
'RebootOption' => '<string>',
],
'Process' => [
'LaunchedAt' => '<string>',
'Name' => '<string>',
'ParentPid' => <integer>,
'Path' => '<string>',
'Pid' => <integer>,
'TerminatedAt' => '<string>',
],
'ProductArn' => '<string>',
'ProductFields' => ['<string>', ...],
'ProductName' => '<string>',
'RecordState' => 'ACTIVE|ARCHIVED',
'Region' => '<string>',
'RelatedFindings' => [
[
'Id' => '<string>',
'ProductArn' => '<string>',
],
// ...
],
'Remediation' => [
'Recommendation' => [
'Text' => '<string>',
'Url' => '<string>',
],
],
'Resources' => [
[
'DataClassification' => [
'DetailedResultsLocation' => '<string>',
'Result' => [
'AdditionalOccurrences' => true || false,
'CustomDataIdentifiers' => [
'Detections' => [
[
'Arn' => '<string>',
'Count' => <integer>,
'Name' => '<string>',
'Occurrences' => [
'Cells' => [
[
'CellReference' => '<string>',
'Column' => <integer>,
'ColumnName' => '<string>',
'Row' => <integer>,
],
// ...
],
'LineRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'OffsetRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'Pages' => [
[
'LineRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'OffsetRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'PageNumber' => <integer>,
],
// ...
],
'Records' => [
[
'JsonPath' => '<string>',
'RecordIndex' => <integer>,
],
// ...
],
],
],
// ...
],
'TotalCount' => <integer>,
],
'MimeType' => '<string>',
'SensitiveData' => [
[
'Category' => '<string>',
'Detections' => [
[
'Count' => <integer>,
'Occurrences' => [
'Cells' => [
[
'CellReference' => '<string>',
'Column' => <integer>,
'ColumnName' => '<string>',
'Row' => <integer>,
],
// ...
],
'LineRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'OffsetRanges' => [
[
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
// ...
],
'Pages' => [
[
'LineRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'OffsetRange' => [
'End' => <integer>,
'Start' => <integer>,
'StartColumn' => <integer>,
],
'PageNumber' => <integer>,
],
// ...
],
'Records' => [
[
'JsonPath' => '<string>',
'RecordIndex' => <integer>,
],
// ...
],
],
'Type' => '<string>',
],
// ...
],
'TotalCount' => <integer>,
],
// ...
],
'SizeClassified' => <integer>,
'Status' => [
'Code' => '<string>',
'Reason' => '<string>',
],
],
],
'Details' => [
'AwsApiGatewayRestApi' => [
'ApiKeySource' => '<string>',
'BinaryMediaTypes' => ['<string>', ...],
'CreatedDate' => '<string>',
'Description' => '<string>',
'EndpointConfiguration' => [
'Types' => ['<string>', ...],
],
'Id' => '<string>',
'MinimumCompressionSize' => <integer>,
'Name' => '<string>',
'Version' => '<string>',
],
'AwsApiGatewayStage' => [
'AccessLogSettings' => [
'DestinationArn' => '<string>',
'Format' => '<string>',
],
'CacheClusterEnabled' => true || false,
'CacheClusterSize' => '<string>',
'CacheClusterStatus' => '<string>',
'CanarySettings' => [
'DeploymentId' => '<string>',
'PercentTraffic' => <float>,
'StageVariableOverrides' => ['<string>', ...],
'UseStageCache' => true || false,
],
'ClientCertificateId' => '<string>',
'CreatedDate' => '<string>',
'DeploymentId' => '<string>',
'Description' => '<string>',
'DocumentationVersion' => '<string>',
'LastUpdatedDate' => '<string>',
'MethodSettings' => [
[
'CacheDataEncrypted' => true || false,
'CacheTtlInSeconds' => <integer>,
'CachingEnabled' => true || false,
'DataTraceEnabled' => true || false,
'HttpMethod' => '<string>',
'LoggingLevel' => '<string>',
'MetricsEnabled' => true || false,
'RequireAuthorizationForCacheControl' => true || false,
'ResourcePath' => '<string>',
'ThrottlingBurstLimit' => <integer>,
'ThrottlingRateLimit' => <float>,
'UnauthorizedCacheControlHeaderStrategy' => '<string>',
],
// ...
],
'StageName' => '<string>',
'TracingEnabled' => true || false,
'Variables' => ['<string>', ...],
'WebAclArn' => '<string>',
],
'AwsApiGatewayV2Api' => [
'ApiEndpoint' => '<string>',
'ApiId' => '<string>',
'ApiKeySelectionExpression' => '<string>',
'CorsConfiguration' => [
'AllowCredentials' => true || false,
'AllowHeaders' => ['<string>', ...],
'AllowMethods' => ['<string>', ...],
'AllowOrigins' => ['<string>', ...],
'ExposeHeaders' => ['<string>', ...],
'MaxAge' => <integer>,
],
'CreatedDate' => '<string>',
'Description' => '<string>',
'Name' => '<string>',
'ProtocolType' => '<string>',
'RouteSelectionExpression' => '<string>',
'Version' => '<string>',
],
'AwsApiGatewayV2Stage' => [
'AccessLogSettings' => [
'DestinationArn' => '<string>',
'Format' => '<string>',
],
'ApiGatewayManaged' => true || false,
'AutoDeploy' => true || false,
'ClientCertificateId' => '<string>',
'CreatedDate' => '<string>',
'DefaultRouteSettings' => [
'DataTraceEnabled' => true || false,
'DetailedMetricsEnabled' => true || false,
'LoggingLevel' => '<string>',
'ThrottlingBurstLimit' => <integer>,
'ThrottlingRateLimit' => <float>,
],
'DeploymentId' => '<string>',
'Description' => '<string>',
'LastDeploymentStatusMessage' => '<string>',
'LastUpdatedDate' => '<string>',
'RouteSettings' => [
'DataTraceEnabled' => true || false,
'DetailedMetricsEnabled' => true || false,
'LoggingLevel' => '<string>',
'ThrottlingBurstLimit' => <integer>,
'ThrottlingRateLimit' => <float>,
],
'StageName' => '<string>',
'StageVariables' => ['<string>', ...],
],
'AwsAutoScalingAutoScalingGroup' => [
'CreatedTime' => '<string>',
'HealthCheckGracePeriod' => <integer>,
'HealthCheckType' => '<string>',
'LaunchConfigurationName' => '<string>',
'LoadBalancerNames' => ['<string>', ...],
],
'AwsCertificateManagerCertificate' => [
'CertificateAuthorityArn' => '<string>',
'CreatedAt' => '<string>',
'DomainName' => '<string>',
'DomainValidationOptions' => [
[
'DomainName' => '<string>',
'ResourceRecord' => [
'Name' => '<string>',
'Type' => '<string>',
'Value' => '<string>',
],
'ValidationDomain' => '<string>',
'ValidationEmails' => ['<string>', ...],
'ValidationMethod' => '<string>',
'ValidationStatus' => '<string>',
],
// ...
],
'ExtendedKeyUsages' => [
[
'Name' => '<string>',
'OId' => '<string>',
],
// ...
],
'FailureReason' => '<string>',
'ImportedAt' => '<string>',
'InUseBy' => ['<string>', ...],
'IssuedAt' => '<string>',
'Issuer' => '<string>',
'KeyAlgorithm' => '<string>',
'KeyUsages' => [
[
'Name' => '<string>',
],
// ...
],
'NotAfter' => '<string>',
'NotBefore' => '<string>',
'Options' => [
'CertificateTransparencyLoggingPreference' => '<string>',
],
'RenewalEligibility' => '<string>',
'RenewalSummary' => [
'DomainValidationOptions' => [
[
'DomainName' => '<string>',
'ResourceRecord' => [
'Name' => '<string>',
'Type' => '<string>',
'Value' => '<string>',
],
'ValidationDomain' => '<string>',
'ValidationEmails' => ['<string>', ...],
'ValidationMethod' => '<string>',
'ValidationStatus' => '<string>',
],
// ...
],
'RenewalStatus' => '<string>',
'RenewalStatusReason' => '<string>',
'UpdatedAt' => '<string>',
],
'Serial' => '<string>',
'SignatureAlgorithm' => '<string>',
'Status' => '<string>',
'Subject' => '<string>',
'SubjectAlternativeNames' => ['<string>', ...],
'Type' => '<string>',
],
'AwsCloudFrontDistribution' => [
'CacheBehaviors' => [
'Items' => [
[
'ViewerProtocolPolicy' => '<string>',
],
// ...
],
],
'DefaultCacheBehavior' => [
'ViewerProtocolPolicy' => '<string>',
],
'DefaultRootObject' => '<string>',
'DomainName' => '<string>',
'ETag' => '<string>',
'LastModifiedTime' => '<string>',
'Logging' => [
'Bucket' => '<string>',
'Enabled' => true || false,
'IncludeCookies' => true || false,
'Prefix' => '<string>',
],
'OriginGroups' => [
'Items' => [
[
'FailoverCriteria' => [
'StatusCodes' => [
'Items' => [<integer>, ...],
'Quantity' => <integer>,
],
],
],
// ...
],
],
'Origins' => [
'Items' => [
[
'DomainName' => '<string>',
'Id' => '<string>',
'OriginPath' => '<string>',
'S3OriginConfig' => [
'OriginAccessIdentity' => '<string>',
],
],
// ...
],
],
'Status' => '<string>',
'WebAclId' => '<string>',
],
'AwsCloudTrailTrail' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'CloudWatchLogsRoleArn' => '<string>',
'HasCustomEventSelectors' => true || false,
'HomeRegion' => '<string>',
'IncludeGlobalServiceEvents' => true || false,
'IsMultiRegionTrail' => true || false,
'IsOrganizationTrail' => true || false,
'KmsKeyId' => '<string>',
'LogFileValidationEnabled' => true || false,
'Name' => '<string>',
'S3BucketName' => '<string>',
'S3KeyPrefix' => '<string>',
'SnsTopicArn' => '<string>',
'SnsTopicName' => '<string>',
'TrailArn' => '<string>',
],
'AwsCodeBuildProject' => [
'EncryptionKey' => '<string>',
'Environment' => [
'Certificate' => '<string>',
'ImagePullCredentialsType' => '<string>',
'RegistryCredential' => [
'Credential' => '<string>',
'CredentialProvider' => '<string>',
],
'Type' => '<string>',
],
'Name' => '<string>',
'ServiceRole' => '<string>',
'Source' => [
'GitCloneDepth' => <integer>,
'InsecureSsl' => true || false,
'Location' => '<string>',
'Type' => '<string>',
],
'VpcConfig' => [
'SecurityGroupIds' => ['<string>', ...],
'Subnets' => ['<string>', ...],
'VpcId' => '<string>',
],
],
'AwsDynamoDbTable' => [
'AttributeDefinitions' => [
[
'AttributeName' => '<string>',
'AttributeType' => '<string>',
],
// ...
],
'BillingModeSummary' => [
'BillingMode' => '<string>',
'LastUpdateToPayPerRequestDateTime' => '<string>',
],
'CreationDateTime' => '<string>',
'GlobalSecondaryIndexes' => [
[
'Backfilling' => true || false,
'IndexArn' => '<string>',
'IndexName' => '<string>',
'IndexSizeBytes' => <integer>,
'IndexStatus' => '<string>',
'ItemCount' => <integer>,
'KeySchema' => [
[
'AttributeName' => '<string>',
'KeyType' => '<string>',
],
// ...
],
'Projection' => [
'NonKeyAttributes' => ['<string>', ...],
'ProjectionType' => '<string>',
],
'ProvisionedThroughput' => [
'LastDecreaseDateTime' => '<string>',
'LastIncreaseDateTime' => '<string>',
'NumberOfDecreasesToday' => <integer>,
'ReadCapacityUnits' => <integer>,
'WriteCapacityUnits' => <integer>,
],
],
// ...
],
'GlobalTableVersion' => '<string>',
'ItemCount' => <integer>,
'KeySchema' => [
[
'AttributeName' => '<string>',
'KeyType' => '<string>',
],
// ...
],
'LatestStreamArn' => '<string>',
'LatestStreamLabel' => '<string>',
'LocalSecondaryIndexes' => [
[
'IndexArn' => '<string>',
'IndexName' => '<string>',
'KeySchema' => [
[
'AttributeName' => '<string>',
'KeyType' => '<string>',
],
// ...
],
'Projection' => [
'NonKeyAttributes' => ['<string>', ...],
'ProjectionType' => '<string>',
],
],
// ...
],
'ProvisionedThroughput' => [
'LastDecreaseDateTime' => '<string>',
'LastIncreaseDateTime' => '<string>',
'NumberOfDecreasesToday' => <integer>,
'ReadCapacityUnits' => <integer>,
'WriteCapacityUnits' => <integer>,
],
'Replicas' => [
[
'GlobalSecondaryIndexes' => [
[
'IndexName' => '<string>',
'ProvisionedThroughputOverride' => [
'ReadCapacityUnits' => <integer>,
],
],
// ...
],
'KmsMasterKeyId' => '<string>',
'ProvisionedThroughputOverride' => [
'ReadCapacityUnits' => <integer>,
],
'RegionName' => '<string>',
'ReplicaStatus' => '<string>',
'ReplicaStatusDescription' => '<string>',
],
// ...
],
'RestoreSummary' => [
'RestoreDateTime' => '<string>',
'RestoreInProgress' => true || false,
'SourceBackupArn' => '<string>',
'SourceTableArn' => '<string>',
],
'SseDescription' => [
'InaccessibleEncryptionDateTime' => '<string>',
'KmsMasterKeyArn' => '<string>',
'SseType' => '<string>',
'Status' => '<string>',
],
'StreamSpecification' => [
'StreamEnabled' => true || false,
'StreamViewType' => '<string>',
],
'TableId' => '<string>',
'TableName' => '<string>',
'TableSizeBytes' => <integer>,
'TableStatus' => '<string>',
],
'AwsEc2Eip' => [
'AllocationId' => '<string>',
'AssociationId' => '<string>',
'Domain' => '<string>',
'InstanceId' => '<string>',
'NetworkBorderGroup' => '<string>',
'NetworkInterfaceId' => '<string>',
'NetworkInterfaceOwnerId' => '<string>',
'PrivateIpAddress' => '<string>',
'PublicIp' => '<string>',
'PublicIpv4Pool' => '<string>',
],
'AwsEc2Instance' => [
'IamInstanceProfileArn' => '<string>',
'ImageId' => '<string>',
'IpV4Addresses' => ['<string>', ...],
'IpV6Addresses' => ['<string>', ...],
'KeyName' => '<string>',
'LaunchedAt' => '<string>',
'NetworkInterfaces' => [
[
'NetworkInterfaceId' => '<string>',
],
// ...
],
'SubnetId' => '<string>',
'Type' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2NetworkAcl' => [
'Associations' => [
[
'NetworkAclAssociationId' => '<string>',
'NetworkAclId' => '<string>',
'SubnetId' => '<string>',
],
// ...
],
'Entries' => [
[
'CidrBlock' => '<string>',
'Egress' => true || false,
'IcmpTypeCode' => [
'Code' => <integer>,
'Type' => <integer>,
],
'Ipv6CidrBlock' => '<string>',
'PortRange' => [
'From' => <integer>,
'To' => <integer>,
],
'Protocol' => '<string>',
'RuleAction' => '<string>',
'RuleNumber' => <integer>,
],
// ...
],
'IsDefault' => true || false,
'NetworkAclId' => '<string>',
'OwnerId' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2NetworkInterface' => [
'Attachment' => [
'AttachTime' => '<string>',
'AttachmentId' => '<string>',
'DeleteOnTermination' => true || false,
'DeviceIndex' => <integer>,
'InstanceId' => '<string>',
'InstanceOwnerId' => '<string>',
'Status' => '<string>',
],
'IpV6Addresses' => [
[
'IpV6Address' => '<string>',
],
// ...
],
'NetworkInterfaceId' => '<string>',
'PrivateIpAddresses' => [
[
'PrivateDnsName' => '<string>',
'PrivateIpAddress' => '<string>',
],
// ...
],
'PublicDnsName' => '<string>',
'PublicIp' => '<string>',
'SecurityGroups' => [
[
'GroupId' => '<string>',
'GroupName' => '<string>',
],
// ...
],
'SourceDestCheck' => true || false,
],
'AwsEc2SecurityGroup' => [
'GroupId' => '<string>',
'GroupName' => '<string>',
'IpPermissions' => [
[
'FromPort' => <integer>,
'IpProtocol' => '<string>',
'IpRanges' => [
[
'CidrIp' => '<string>',
],
// ...
],
'Ipv6Ranges' => [
[
'CidrIpv6' => '<string>',
],
// ...
],
'PrefixListIds' => [
[
'PrefixListId' => '<string>',
],
// ...
],
'ToPort' => <integer>,
'UserIdGroupPairs' => [
[
'GroupId' => '<string>',
'GroupName' => '<string>',
'PeeringStatus' => '<string>',
'UserId' => '<string>',
'VpcId' => '<string>',
'VpcPeeringConnectionId' => '<string>',
],
// ...
],
],
// ...
],
'IpPermissionsEgress' => [
[
'FromPort' => <integer>,
'IpProtocol' => '<string>',
'IpRanges' => [
[
'CidrIp' => '<string>',
],
// ...
],
'Ipv6Ranges' => [
[
'CidrIpv6' => '<string>',
],
// ...
],
'PrefixListIds' => [
[
'PrefixListId' => '<string>',
],
// ...
],
'ToPort' => <integer>,
'UserIdGroupPairs' => [
[
'GroupId' => '<string>',
'GroupName' => '<string>',
'PeeringStatus' => '<string>',
'UserId' => '<string>',
'VpcId' => '<string>',
'VpcPeeringConnectionId' => '<string>',
],
// ...
],
],
// ...
],
'OwnerId' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2Subnet' => [
'AssignIpv6AddressOnCreation' => true || false,
'AvailabilityZone' => '<string>',
'AvailabilityZoneId' => '<string>',
'AvailableIpAddressCount' => <integer>,
'CidrBlock' => '<string>',
'DefaultForAz' => true || false,
'Ipv6CidrBlockAssociationSet' => [
[
'AssociationId' => '<string>',
'CidrBlockState' => '<string>',
'Ipv6CidrBlock' => '<string>',
],
// ...
],
'MapPublicIpOnLaunch' => true || false,
'OwnerId' => '<string>',
'State' => '<string>',
'SubnetArn' => '<string>',
'SubnetId' => '<string>',
'VpcId' => '<string>',
],
'AwsEc2Volume' => [
'Attachments' => [
[
'AttachTime' => '<string>',
'DeleteOnTermination' => true || false,
'InstanceId' => '<string>',
'Status' => '<string>',
],
// ...
],
'CreateTime' => '<string>',
'Encrypted' => true || false,
'KmsKeyId' => '<string>',
'Size' => <integer>,
'SnapshotId' => '<string>',
'Status' => '<string>',
],
'AwsEc2Vpc' => [
'CidrBlockAssociationSet' => [
[
'AssociationId' => '<string>',
'CidrBlock' => '<string>',
'CidrBlockState' => '<string>',
],
// ...
],
'DhcpOptionsId' => '<string>',
'Ipv6CidrBlockAssociationSet' => [
[
'AssociationId' => '<string>',
'CidrBlockState' => '<string>',
'Ipv6CidrBlock' => '<string>',
],
// ...
],
'State' => '<string>',
],
'AwsEcsCluster' => [
'CapacityProviders' => ['<string>', ...],
'ClusterSettings' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'Configuration' => [
'ExecuteCommandConfiguration' => [
'KmsKeyId' => '<string>',
'LogConfiguration' => [
'CloudWatchEncryptionEnabled' => true || false,
'CloudWatchLogGroupName' => '<string>',
'S3BucketName' => '<string>',
'S3EncryptionEnabled' => true || false,
'S3KeyPrefix' => '<string>',
],
'Logging' => '<string>',
],
],
'DefaultCapacityProviderStrategy' => [
[
'Base' => <integer>,
'CapacityProvider' => '<string>',
'Weight' => <integer>,
],
// ...
],
],
'AwsEcsService' => [
'CapacityProviderStrategy' => [
[
'Base' => <integer>,
'CapacityProvider' => '<string>',
'Weight' => <integer>,
],
// ...
],
'Cluster' => '<string>',
'DeploymentConfiguration' => [
'DeploymentCircuitBreaker' => [
'Enable' => true || false,
'Rollback' => true || false,
],
'MaximumPercent' => <integer>,
'MinimumHealthyPercent' => <integer>,
],
'DeploymentController' => [
'Type' => '<string>',
],
'DesiredCount' => <integer>,
'EnableEcsManagedTags' => true || false,
'EnableExecuteCommand' => true || false,
'HealthCheckGracePeriodSeconds' => <integer>,
'LaunchType' => '<string>',
'LoadBalancers' => [
[
'ContainerName' => '<string>',
'ContainerPort' => <integer>,
'LoadBalancerName' => '<string>',
'TargetGroupArn' => '<string>',
],
// ...
],
'Name' => '<string>',
'NetworkConfiguration' => [
'AwsVpcConfiguration' => [
'AssignPublicIp' => '<string>',
'SecurityGroups' => ['<string>', ...],
'Subnets' => ['<string>', ...],
],
],
'PlacementConstraints' => [
[
'Expression' => '<string>',
'Type' => '<string>',
],
// ...
],
'PlacementStrategies' => [
[
'Field' => '<string>',
'Type' => '<string>',
],
// ...
],
'PlatformVersion' => '<string>',
'PropagateTags' => '<string>',
'Role' => '<string>',
'SchedulingStrategy' => '<string>',
'ServiceArn' => '<string>',
'ServiceName' => '<string>',
'ServiceRegistries' => [
[
'ContainerName' => '<string>',
'ContainerPort' => <integer>,
'Port' => <integer>,
'RegistryArn' => '<string>',
],
// ...
],
'TaskDefinition' => '<string>',
],
'AwsEcsTaskDefinition' => [
'ContainerDefinitions' => [
[
'Command' => ['<string>', ...],
'Cpu' => <integer>,
'DependsOn' => [
[
'Condition' => '<string>',
'ContainerName' => '<string>',
],
// ...
],
'DisableNetworking' => true || false,
'DnsSearchDomains' => ['<string>', ...],
'DnsServers' => ['<string>', ...],
'DockerLabels' => ['<string>', ...],
'DockerSecurityOptions' => ['<string>', ...],
'EntryPoint' => ['<string>', ...],
'Environment' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'EnvironmentFiles' => [
[
'Type' => '<string>',
'Value' => '<string>',
],
// ...
],
'Essential' => true || false,
'ExtraHosts' => [
[
'Hostname' => '<string>',
'IpAddress' => '<string>',
],
// ...
],
'FirelensConfiguration' => [
'Options' => ['<string>', ...],
'Type' => '<string>',
],
'HealthCheck' => [
'Command' => ['<string>', ...],
'Interval' => <integer>,
'Retries' => <integer>,
'StartPeriod' => <integer>,
'Timeout' => <integer>,
],
'Hostname' => '<string>',
'Image' => '<string>',
'Interactive' => true || false,
'Links' => ['<string>', ...],
'LinuxParameters' => [
'Capabilities' => [
'Add' => ['<string>', ...],
'Drop' => ['<string>', ...],
],
'Devices' => [
[
'ContainerPath' => '<string>',
'HostPath' => '<string>',
'Permissions' => ['<string>', ...],
],
// ...
],
'InitProcessEnabled' => true || false,
'MaxSwap' => <integer>,
'SharedMemorySize' => <integer>,
'Swappiness' => <integer>,
'Tmpfs' => [
[
'ContainerPath' => '<string>',
'MountOptions' => ['<string>', ...],
'Size' => <integer>,
],
// ...
],
],
'LogConfiguration' => [
'LogDriver' => '<string>',
'Options' => ['<string>', ...],
'SecretOptions' => [
[
'Name' => '<string>',
'ValueFrom' => '<string>',
],
// ...
],
],
'Memory' => <integer>,
'MemoryReservation' => <integer>,
'MountPoints' => [
[
'ContainerPath' => '<string>',
'ReadOnly' => true || false,
'SourceVolume' => '<string>',
],
// ...
],
'Name' => '<string>',
'PortMappings' => [
[
'ContainerPort' => <integer>,
'HostPort' => <integer>,
'Protocol' => '<string>',
],
// ...
],
'Privileged' => true || false,
'PseudoTerminal' => true || false,
'ReadonlyRootFilesystem' => true || false,
'RepositoryCredentials' => [
'CredentialsParameter' => '<string>',
],
'ResourceRequirements' => [
[
'Type' => '<string>',
'Value' => '<string>',
],
// ...
],
'Secrets' => [
[
'Name' => '<string>',
'ValueFrom' => '<string>',
],
// ...
],
'StartTimeout' => <integer>,
'StopTimeout' => <integer>,
'SystemControls' => [
[
'Namespace' => '<string>',
'Value' => '<string>',
],
// ...
],
'Ulimits' => [
[
'HardLimit' => <integer>,
'Name' => '<string>',
'SoftLimit' => <integer>,
],
// ...
],
'User' => '<string>',
'VolumesFrom' => [
[
'ReadOnly' => true || false,
'SourceContainer' => '<string>',
],
// ...
],
'WorkingDirectory' => '<string>',
],
// ...
],
'Cpu' => '<string>',
'ExecutionRoleArn' => '<string>',
'Family' => '<string>',
'InferenceAccelerators' => [
[
'DeviceName' => '<string>',
'DeviceType' => '<string>',
],
// ...
],
'IpcMode' => '<string>',
'Memory' => '<string>',
'NetworkMode' => '<string>',
'PidMode' => '<string>',
'PlacementConstraints' => [
[
'Expression' => '<string>',
'Type' => '<string>',
],
// ...
],
'ProxyConfiguration' => [
'ContainerName' => '<string>',
'ProxyConfigurationProperties' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'Type' => '<string>',
],
'RequiresCompatibilities' => ['<string>', ...],
'TaskRoleArn' => '<string>',
'Volumes' => [
[
'DockerVolumeConfiguration' => [
'Autoprovision' => true || false,
'Driver' => '<string>',
'DriverOpts' => ['<string>', ...],
'Labels' => ['<string>', ...],
'Scope' => '<string>',
],
'EfsVolumeConfiguration' => [
'AuthorizationConfig' => [
'AccessPointId' => '<string>',
'Iam' => '<string>',
],
'FilesystemId' => '<string>',
'RootDirectory' => '<string>',
'TransitEncryption' => '<string>',
'TransitEncryptionPort' => <integer>,
],
'Host' => [
'SourcePath' => '<string>',
],
'Name' => '<string>',
],
// ...
],
],
'AwsElasticBeanstalkEnvironment' => [
'ApplicationName' => '<string>',
'Cname' => '<string>',
'DateCreated' => '<string>',
'DateUpdated' => '<string>',
'Description' => '<string>',
'EndpointUrl' => '<string>',
'EnvironmentArn' => '<string>',
'EnvironmentId' => '<string>',
'EnvironmentLinks' => [
[
'EnvironmentName' => '<string>',
'LinkName' => '<string>',
],
// ...
],
'EnvironmentName' => '<string>',
'OptionSettings' => [
[
'Namespace' => '<string>',
'OptionName' => '<string>',
'ResourceName' => '<string>',
'Value' => '<string>',
],
// ...
],
'PlatformArn' => '<string>',
'SolutionStackName' => '<string>',
'Status' => '<string>',
'Tier' => [
'Name' => '<string>',
'Type' => '<string>',
'Version' => '<string>',
],
'VersionLabel' => '<string>',
],
'AwsElasticsearchDomain' => [
'AccessPolicies' => '<string>',
'DomainEndpointOptions' => [
'EnforceHTTPS' => true || false,
'TLSSecurityPolicy' => '<string>',
],
'DomainId' => '<string>',
'DomainName' => '<string>',
'ElasticsearchClusterConfig' => [
'DedicatedMasterCount' => <integer>,
'DedicatedMasterEnabled' => true || false,
'DedicatedMasterType' => '<string>',
'InstanceCount' => <integer>,
'InstanceType' => '<string>',
'ZoneAwarenessConfig' => [
'AvailabilityZoneCount' => <integer>,
],
'ZoneAwarenessEnabled' => true || false,
],
'ElasticsearchVersion' => '<string>',
'EncryptionAtRestOptions' => [
'Enabled' => true || false,
'KmsKeyId' => '<string>',
],
'Endpoint' => '<string>',
'Endpoints' => ['<string>', ...],
'LogPublishingOptions' => [
'AuditLogs' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'Enabled' => true || false,
],
'IndexSlowLogs' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'Enabled' => true || false,
],
'SearchSlowLogs' => [
'CloudWatchLogsLogGroupArn' => '<string>',
'Enabled' => true || false,
],
],
'NodeToNodeEncryptionOptions' => [
'Enabled' => true || false,
],
'ServiceSoftwareOptions' => [
'AutomatedUpdateDate' => '<string>',
'Cancellable' => true || false,
'CurrentVersion' => '<string>',
'Description' => '<string>',
'NewVersion' => '<string>',
'UpdateAvailable' => true || false,
'UpdateStatus' => '<string>',
],
'VPCOptions' => [
'AvailabilityZones' => ['<string>', ...],
'SecurityGroupIds' => ['<string>', ...],
'SubnetIds' => ['<string>', ...],
'VPCId' => '<string>',
],
],
'AwsElbLoadBalancer' => [
'AvailabilityZones' => ['<string>', ...],
'BackendServerDescriptions' => [
[
'InstancePort' => <integer>,
'PolicyNames' => ['<string>', ...],
],
// ...
],
'CanonicalHostedZoneName' => '<string>',
'CanonicalHostedZoneNameID' => '<string>',
'CreatedTime' => '<string>',
'DnsName' => '<string>',
'HealthCheck' => [
'HealthyThreshold' => <integer>,
'Interval' => <integer>,
'Target' => '<string>',
'Timeout' => <integer>,
'UnhealthyThreshold' => <integer>,
],
'Instances' => [
[
'InstanceId' => '<string>',
],
// ...
],
'ListenerDescriptions' => [
[
'Listener' => [
'InstancePort' => <integer>,
'InstanceProtocol' => '<string>',
'LoadBalancerPort' => <integer>,
'Protocol' => '<string>',
'SslCertificateId' => '<string>',
],
'PolicyNames' => ['<string>', ...],
],
// ...
],
'LoadBalancerAttributes' => [
'AccessLog' => [
'EmitInterval' => <integer>,
'Enabled' => true || false,
'S3BucketName' => '<string>',
'S3BucketPrefix' => '<string>',
],
'ConnectionDraining' => [
'Enabled' => true || false,
'Timeout' => <integer>,
],
'ConnectionSettings' => [
'IdleTimeout' => <integer>,
],
'CrossZoneLoadBalancing' => [
'Enabled' => true || false,
],
],
'LoadBalancerName' => '<string>',
'Policies' => [
'AppCookieStickinessPolicies' => [
[
'CookieName' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'LbCookieStickinessPolicies' => [
[
'CookieExpirationPeriod' => <integer>,
'PolicyName' => '<string>',
],
// ...
],
'OtherPolicies' => ['<string>', ...],
],
'Scheme' => '<string>',
'SecurityGroups' => ['<string>', ...],
'SourceSecurityGroup' => [
'GroupName' => '<string>',
'OwnerAlias' => '<string>',
],
'Subnets' => ['<string>', ...],
'VpcId' => '<string>',
],
'AwsElbv2LoadBalancer' => [
'AvailabilityZones' => [
[
'SubnetId' => '<string>',
'ZoneName' => '<string>',
],
// ...
],
'CanonicalHostedZoneId' => '<string>',
'CreatedTime' => '<string>',
'DNSName' => '<string>',
'IpAddressType' => '<string>',
'Scheme' => '<string>',
'SecurityGroups' => ['<string>', ...],
'State' => [
'Code' => '<string>',
'Reason' => '<string>',
],
'Type' => '<string>',
'VpcId' => '<string>',
],
'AwsIamAccessKey' => [
'AccessKeyId' => '<string>',
'AccountId' => '<string>',
'CreatedAt' => '<string>',
'PrincipalId' => '<string>',
'PrincipalName' => '<string>',
'PrincipalType' => '<string>',
'SessionContext' => [
'Attributes' => [
'CreationDate' => '<string>',
'MfaAuthenticated' => true || false,
],
'SessionIssuer' => [
'AccountId' => '<string>',
'Arn' => '<string>',
'PrincipalId' => '<string>',
'Type' => '<string>',
'UserName' => '<string>',
],
],
'Status' => 'Active|Inactive',
'UserName' => '<string>',
],
'AwsIamGroup' => [
'AttachedManagedPolicies' => [
[
'PolicyArn' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'CreateDate' => '<string>',
'GroupId' => '<string>',
'GroupName' => '<string>',
'GroupPolicyList' => [
[
'PolicyName' => '<string>',
],
// ...
],
'Path' => '<string>',
],
'AwsIamPolicy' => [
'AttachmentCount' => <integer>,
'CreateDate' => '<string>',
'DefaultVersionId' => '<string>',
'Description' => '<string>',
'IsAttachable' => true || false,
'Path' => '<string>',
'PermissionsBoundaryUsageCount' => <integer>,
'PolicyId' => '<string>',
'PolicyName' => '<string>',
'PolicyVersionList' => [
[
'CreateDate' => '<string>',
'IsDefaultVersion' => true || false,
'VersionId' => '<string>',
],
// ...
],
'UpdateDate' => '<string>',
],
'AwsIamRole' => [
'AssumeRolePolicyDocument' => '<string>',
'AttachedManagedPolicies' => [
[
'PolicyArn' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'CreateDate' => '<string>',
'InstanceProfileList' => [
[
'Arn' => '<string>',
'CreateDate' => '<string>',
'InstanceProfileId' => '<string>',
'InstanceProfileName' => '<string>',
'Path' => '<string>',
'Roles' => [
[
'Arn' => '<string>',
'AssumeRolePolicyDocument' => '<string>',
'CreateDate' => '<string>',
'Path' => '<string>',
'RoleId' => '<string>',
'RoleName' => '<string>',
],
// ...
],
],
// ...
],
'MaxSessionDuration' => <integer>,
'Path' => '<string>',
'PermissionsBoundary' => [
'PermissionsBoundaryArn' => '<string>',
'PermissionsBoundaryType' => '<string>',
],
'RoleId' => '<string>',
'RoleName' => '<string>',
'RolePolicyList' => [
[
'PolicyName' => '<string>',
],
// ...
],
],
'AwsIamUser' => [
'AttachedManagedPolicies' => [
[
'PolicyArn' => '<string>',
'PolicyName' => '<string>',
],
// ...
],
'CreateDate' => '<string>',
'GroupList' => ['<string>', ...],
'Path' => '<string>',
'PermissionsBoundary' => [
'PermissionsBoundaryArn' => '<string>',
'PermissionsBoundaryType' => '<string>',
],
'UserId' => '<string>',
'UserName' => '<string>',
'UserPolicyList' => [
[
'PolicyName' => '<string>',
],
// ...
],
],
'AwsKmsKey' => [
'AWSAccountId' => '<string>',
'CreationDate' => <float>,
'Description' => '<string>',
'KeyId' => '<string>',
'KeyManager' => '<string>',
'KeyState' => '<string>',
'Origin' => '<string>',
],
'AwsLambdaFunction' => [
'Code' => [
'S3Bucket' => '<string>',
'S3Key' => '<string>',
'S3ObjectVersion' => '<string>',
'ZipFile' => '<string>',
],
'CodeSha256' => '<string>',
'DeadLetterConfig' => [
'TargetArn' => '<string>',
],
'Environment' => [
'Error' => [
'ErrorCode' => '<string>',
'Message' => '<string>',
],
'Variables' => ['<string>', ...],
],
'FunctionName' => '<string>',
'Handler' => '<string>',
'KmsKeyArn' => '<string>',
'LastModified' => '<string>',
'Layers' => [
[
'Arn' => '<string>',
'CodeSize' => <integer>,
],
// ...
],
'MasterArn' => '<string>',
'MemorySize' => <integer>,
'RevisionId' => '<string>',
'Role' => '<string>',
'Runtime' => '<string>',
'Timeout' => <integer>,
'TracingConfig' => [
'Mode' => '<string>',
],
'Version' => '<string>',
'VpcConfig' => [
'SecurityGroupIds' => ['<string>', ...],
'SubnetIds' => ['<string>', ...],
'VpcId' => '<string>',
],
],
'AwsLambdaLayerVersion' => [
'CompatibleRuntimes' => ['<string>', ...],
'CreatedDate' => '<string>',
'Version' => <integer>,
],
'AwsRdsDbCluster' => [
'ActivityStreamStatus' => '<string>',
'AllocatedStorage' => <integer>,
'AssociatedRoles' => [
[
'RoleArn' => '<string>',
'Status' => '<string>',
],
// ...
],
'AvailabilityZones' => ['<string>', ...],
'BackupRetentionPeriod' => <integer>,
'ClusterCreateTime' => '<string>',
'CopyTagsToSnapshot' => true || false,
'CrossAccountClone' => true || false,
'CustomEndpoints' => ['<string>', ...],
'DatabaseName' => '<string>',
'DbClusterIdentifier' => '<string>',
'DbClusterMembers' => [
[
'DbClusterParameterGroupStatus' => '<string>',
'DbInstanceIdentifier' => '<string>',
'IsClusterWriter' => true || false,
'PromotionTier' => <integer>,
],
// ...
],
'DbClusterOptionGroupMemberships' => [
[
'DbClusterOptionGroupName' => '<string>',
'Status' => '<string>',
],
// ...
],
'DbClusterParameterGroup' => '<string>',
'DbClusterResourceId' => '<string>',
'DbSubnetGroup' => '<string>',
'DeletionProtection' => true || false,
'DomainMemberships' => [
[
'Domain' => '<string>',
'Fqdn' => '<string>',
'IamRoleName' => '<string>',
'Status' => '<string>',
],
// ...
],
'EnabledCloudWatchLogsExports' => ['<string>', ...],
'Endpoint' => '<string>',
'Engine' => '<string>',
'EngineMode' => '<string>',
'EngineVersion' => '<string>',
'HostedZoneId' => '<string>',
'HttpEndpointEnabled' => true || false,
'IamDatabaseAuthenticationEnabled' => true || false,
'KmsKeyId' => '<string>',
'MasterUsername' => '<string>',
'MultiAz' => true || false,
'Port' => <integer>,
'PreferredBackupWindow' => '<string>',
'PreferredMaintenanceWindow' => '<string>',
'ReadReplicaIdentifiers' => ['<string>', ...],
'ReaderEndpoint' => '<string>',
'Status' => '<string>',
'StorageEncrypted' => true || false,
'VpcSecurityGroups' => [
[
'Status' => '<string>',
'VpcSecurityGroupId' => '<string>',
],
// ...
],
],
'AwsRdsDbClusterSnapshot' => [
'AllocatedStorage' => <integer>,
'AvailabilityZones' => ['<string>', ...],
'ClusterCreateTime' => '<string>',
'DbClusterIdentifier' => '<string>',
'DbClusterSnapshotIdentifier' => '<string>',
'Engine' => '<string>',
'EngineVersion' => '<string>',
'IamDatabaseAuthenticationEnabled' => true || false,
'KmsKeyId' => '<string>',
'LicenseModel' => '<string>',
'MasterUsername' => '<string>',
'PercentProgress' => <integer>,
'Port' => <integer>,
'SnapshotCreateTime' => '<string>',
'SnapshotType' => '<string>',
'Status' => '<string>',
'StorageEncrypted' => true || false,
'VpcId' => '<string>',
],
'AwsRdsDbInstance' => [
'AllocatedStorage' => <integer>,
'AssociatedRoles' => [
[
'FeatureName' => '<string>',
'RoleArn' => '<string>',
'Status' => '<string>',
],
// ...
],
'AutoMinorVersionUpgrade' => true || false,
'AvailabilityZone' => '<string>',
'BackupRetentionPeriod' => <integer>,
'CACertificateIdentifier' => '<string>',
'CharacterSetName' => '<string>',
'CopyTagsToSnapshot' => true || false,
'DBClusterIdentifier' => '<string>',
'DBInstanceClass' => '<string>',
'DBInstanceIdentifier' => '<string>',
'DBName' => '<string>',
'DbInstancePort' => <integer>,
'DbInstanceStatus' => '<string>',
'DbParameterGroups' => [
[
'DbParameterGroupName' => '<string>',
'ParameterApplyStatus' => '<string>',
],
// ...
],
'DbSecurityGroups' => ['<string>', ...],
'DbSubnetGroup' => [
'DbSubnetGroupArn' => '<string>',
'DbSubnetGroupDescription' => '<string>',
'DbSubnetGroupName' => '<string>',
'SubnetGroupStatus' => '<string>',
'Subnets' => [
[
'SubnetAvailabilityZone' => [
'Name' => '<string>',
],
'SubnetIdentifier' => '<string>',
'SubnetStatus' => '<string>',
],
// ...
],
'VpcId' => '<string>',
],
'DbiResourceId' => '<string>',
'DeletionProtection' => true || false,
'DomainMemberships' => [
[
'Domain' => '<string>',
'Fqdn' => '<string>',
'IamRoleName' => '<string>',
'Status' => '<string>',
],
// ...
],
'EnabledCloudWatchLogsExports' => ['<string>', ...],
'Endpoint' => [
'Address' => '<string>',
'HostedZoneId' => '<string>',
'Port' => <integer>,
],
'Engine' => '<string>',
'EngineVersion' => '<string>',
'EnhancedMonitoringResourceArn' => '<string>',
'IAMDatabaseAuthenticationEnabled' => true || false,
'InstanceCreateTime' => '<string>',
'Iops' => <integer>,
'KmsKeyId' => '<string>',
'LatestRestorableTime' => '<string>',
'LicenseModel' => '<string>',
'ListenerEndpoint' => [
'Address' => '<string>',
'HostedZoneId' => '<string>',
'Port' => <integer>,
],
'MasterUsername' => '<string>',
'MaxAllocatedStorage' => <integer>,
'MonitoringInterval' => <integer>,
'MonitoringRoleArn' => '<string>',
'MultiAz' => true || false,
'OptionGroupMemberships' => [
[
'OptionGroupName' => '<string>',
'Status' => '<string>',
],
// ...
],
'PendingModifiedValues' => [
'AllocatedStorage' => <integer>,
'BackupRetentionPeriod' => <integer>,
'CaCertificateIdentifier' => '<string>',
'DbInstanceClass' => '<string>',
'DbInstanceIdentifier' => '<string>',
'DbSubnetGroupName' => '<string>',
'EngineVersion' => '<string>',
'Iops' => <integer>,
'LicenseModel' => '<string>',
'MasterUserPassword' => '<string>',
'MultiAZ' => true || false,
'PendingCloudWatchLogsExports' => [
'LogTypesToDisable' => ['<string>', ...],
'LogTypesToEnable' => ['<string>', ...],
],
'Port' => <integer>,
'ProcessorFeatures' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'StorageType' => '<string>',
],
'PerformanceInsightsEnabled' => true || false,
'PerformanceInsightsKmsKeyId' => '<string>',
'PerformanceInsightsRetentionPeriod' => <integer>,
'PreferredBackupWindow' => '<string>',
'PreferredMaintenanceWindow' => '<string>',
'ProcessorFeatures' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'PromotionTier' => <integer>,
'PubliclyAccessible' => true || false,
'ReadReplicaDBClusterIdentifiers' => ['<string>', ...],
'ReadReplicaDBInstanceIdentifiers' => ['<string>', ...],
'ReadReplicaSourceDBInstanceIdentifier' => '<string>',
'SecondaryAvailabilityZone' => '<string>',
'StatusInfos' => [
[
'Message' => '<string>',
'Normal' => true || false,
'Status' => '<string>',
'StatusType' => '<string>',
],
// ...
],
'StorageEncrypted' => true || false,
'StorageType' => '<string>',
'TdeCredentialArn' => '<string>',
'Timezone' => '<string>',
'VpcSecurityGroups' => [
[
'Status' => '<string>',
'VpcSecurityGroupId' => '<string>',
],
// ...
],
],
'AwsRdsDbSnapshot' => [
'AllocatedStorage' => <integer>,
'AvailabilityZone' => '<string>',
'DbInstanceIdentifier' => '<string>',
'DbSnapshotIdentifier' => '<string>',
'DbiResourceId' => '<string>',
'Encrypted' => true || false,
'Engine' => '<string>',
'EngineVersion' => '<string>',
'IamDatabaseAuthenticationEnabled' => true || false,
'InstanceCreateTime' => '<string>',
'Iops' => <integer>,
'KmsKeyId' => '<string>',
'LicenseModel' => '<string>',
'MasterUsername' => '<string>',
'OptionGroupName' => '<string>',
'PercentProgress' => <integer>,
'Port' => <integer>,
'ProcessorFeatures' => [
[
'Name' => '<string>',
'Value' => '<string>',
],
// ...
],
'SnapshotCreateTime' => '<string>',
'SnapshotType' => '<string>',
'SourceDbSnapshotIdentifier' => '<string>',
'SourceRegion' => '<string>',
'Status' => '<string>',
'StorageType' => '<string>',
'TdeCredentialArn' => '<string>',
'Timezone' => '<string>',
'VpcId' => '<string>',
],
'AwsRdsEventSubscription' => [
'CustSubscriptionId' => '<string>',
'CustomerAwsId' => '<string>',
'Enabled' => true || false,
'EventCategoriesList' => ['<string>', ...],
'EventSubscriptionArn' => '<string>',
'SnsTopicArn' => '<string>',
'SourceIdsList' => ['<string>', ...],
'SourceType' => '<string>',
'Status' => '<string>',
'SubscriptionCreationTime' => '<string>',
],
'AwsRedshiftCluster' => [
'AllowVersionUpgrade' => true || false,
'AutomatedSnapshotRetentionPeriod' => <integer>,
'AvailabilityZone' => '<string>',
'ClusterAvailabilityStatus' => '<string>',
'ClusterCreateTime' => '<string>',
'ClusterIdentifier' => '<string>',
'ClusterNodes' => [
[
'NodeRole' => '<string>',
'PrivateIpAddress' => '<string>',
'PublicIpAddress' => '<string>',
],
// ...
],
'ClusterParameterGroups' => [
[
'ClusterParameterStatusList' => [
[
'ParameterApplyErrorDescription' => '<string>',
'ParameterApplyStatus' => '<string>',
'ParameterName' => '<string>',
],
// ...
],
'ParameterApplyStatus' => '<string>',
'ParameterGroupName' => '<string>',
],
// ...
],
'ClusterPublicKey' => '<string>',
'ClusterRevisionNumber' => '<string>',
'ClusterSecurityGroups' => [
[
'ClusterSecurityGroupName' => '<string>',
'Status' => '<string>',
],
// ...
],
'ClusterSnapshotCopyStatus' => [
'DestinationRegion' => '<string>',
'ManualSnapshotRetentionPeriod' => <integer>,
'RetentionPeriod' => <integer>,
'SnapshotCopyGrantName' => '<string>',
],
'ClusterStatus' => '<string>',
'ClusterSubnetGroupName' => '<string>',
'ClusterVersion' => '<string>',
'DBName' => '<string>',
'DeferredMaintenanceWindows' => [
[
'DeferMaintenanceEndTime' => '<string>',
'DeferMaintenanceIdentifier' => '<string>',
'DeferMaintenanceStartTime' => '<string>',
],
// ...
],
'ElasticIpStatus' => [
'ElasticIp' => '<string>',
'Status' => '<string>',
],
'ElasticResizeNumberOfNodeOptions' => '<string>',
'Encrypted' => true || false,
'Endpoint' => [
'Address' => '<string>',
'Port' => <integer>,
],
'EnhancedVpcRouting' => true || false,
'ExpectedNextSnapshotScheduleTime' => '<string>',
'ExpectedNextSnapshotScheduleTimeStatus' => '<string>',
'HsmStatus' => [
'HsmClientCertificateIdentifier' => '<string>',
'HsmConfigurationIdentifier' => '<string>',
'Status' => '<string>',
],
'IamRoles' => [
[
'ApplyStatus' => '<string>',
'IamRoleArn' => '<string>',
],
// ...
],
'KmsKeyId' => '<string>',
'MaintenanceTrackName' => '<string>',
'ManualSnapshotRetentionPeriod' => <integer>,
'MasterUsername' => '<string>',
'NextMaintenanceWindowStartTime' => '<string>',
'NodeType' => '<string>',
'NumberOfNodes' => <integer>,
'PendingActions' => ['<string>', ...],
'PendingModifiedValues' => [
'AutomatedSnapshotRetentionPeriod' => <integer>,
'ClusterIdentifier' => '<string>',
'ClusterType' => '<string>',
'ClusterVersion' => '<string>',
'EncryptionType' => '<string>',
'EnhancedVpcRouting' => true || false,
'MaintenanceTrackName' => '<string>',
'MasterUserPassword' => '<string>',
'NodeType' => '<string>',
'NumberOfNodes' => <integer>,
'PubliclyAccessible' => true || false,
],
'PreferredMaintenanceWindow' => '<string>',
'PubliclyAccessible' => true || false,
'ResizeInfo' => [
'AllowCancelResize' => true || false,
'ResizeType' => '<string>',
],
'RestoreStatus' => [
'CurrentRestoreRateInMegaBytesPerSecond' => <float>,
'ElapsedTimeInSeconds' => <integer>,
'EstimatedTimeToCompletionInSeconds' => <integer>,
'ProgressInMegaBytes' => <integer>,
'SnapshotSizeInMegaBytes' => <integer>,
'Status' => '<string>',
],
'SnapshotScheduleIdentifier' => '<string>',
'SnapshotScheduleState' => '<string>',
'VpcId' => '<string>',
'VpcSecurityGroups' => [
[
'Status' => '<string>',
'VpcSecurityGroupId' => '<string>',
],
// ...
],
],
'AwsS3AccountPublicAccessBlock' => [
'BlockPublicAcls' => true || false,
'BlockPublicPolicy' => true || false,
'IgnorePublicAcls' => true || false,
'RestrictPublicBuckets' => true || false,
],
'AwsS3Bucket' => [
'BucketLifecycleConfiguration' => [
'Rules' => [
[
'AbortIncompleteMultipartUpload' => [
'DaysAfterInitiation' => <integer>,
],
'ExpirationDate' => '<string>',
'ExpirationInDays' => <integer>,
'ExpiredObjectDeleteMarker' => true || false,
'Filter' => [
'Predicate' => [
'Operands' => [
[
'Prefix' => '<string>',
'Tag' => [
'Key' => '<string>',
'Value' => '<string>',
],
'Type' => '<string>',
],
// ...
],
'Prefix' => '<string>',
'Tag' => [
'Key' => '<string>',
'Value' => '<string>',
],
'Type' => '<string>',
],
],
'ID' => '<string>',
'NoncurrentVersionExpirationInDays' => <integer>,
'NoncurrentVersionTransitions' => [
[
'Days' => <integer>,
'StorageClass' => '<string>',
],
// ...
],
'Prefix' => '<string>',
'Status' => '<string>',
'Transitions' => [
[
'Date' => '<string>',
'Days' => <integer>,
'StorageClass' => '<string>',
],
// ...
],
],
// ...
],
],
'CreatedAt' => '<string>',
'OwnerId' => '<string>',
'OwnerName' => '<string>',
'PublicAccessBlockConfiguration' => [
'BlockPublicAcls' => true || false,
'BlockPublicPolicy' => true || false,
'IgnorePublicAcls' => true || false,
'RestrictPublicBuckets' => true || false,
],
'ServerSideEncryptionConfiguration' => [
'Rules' => [
[
'ApplyServerSideEncryptionByDefault' => [
'KMSMasterKeyID' => '<string>',
'SSEAlgorithm' => '<string>',
],
],
// ...
],
],
],
'AwsS3Object' => [
'ContentType' => '<string>',
'ETag' => '<string>',
'LastModified' => '<string>',
'SSEKMSKeyId' => '<string>',
'ServerSideEncryption' => '<string>',
'VersionId' => '<string>',
],
'AwsSecretsManagerSecret' => [
'Deleted' => true || false,
'Description' => '<string>',
'KmsKeyId' => '<string>',
'Name' => '<string>',
'RotationEnabled' => true || false,
'RotationLambdaArn' => '<string>',
'RotationOccurredWithinFrequency' => true || false,
'RotationRules' => [
'AutomaticallyAfterDays' => <integer>,
],
],
'AwsSnsTopic' => [
'KmsMasterKeyId' => '<string>',
'Owner' => '<string>',
'Subscription' => [
[
'Endpoint' => '<string>',
'Protocol' => '<string>',
],
// ...
],
'TopicName' => '<string>',
],
'AwsSqsQueue' => [
'DeadLetterTargetArn' => '<string>',
'KmsDataKeyReusePeriodSeconds' => <integer>,
'KmsMasterKeyId' => '<string>',
'QueueName' => '<string>',
],
'AwsSsmPatchCompliance' => [
'Patch' => [
'ComplianceSummary' => [
'ComplianceType' => '<string>',
'CompliantCriticalCount' => <integer>,
'CompliantHighCount' => <integer>,
'CompliantInformationalCount' => <integer>,
'CompliantLowCount' => <integer>,
'CompliantMediumCount' => <integer>,
'CompliantUnspecifiedCount' => <integer>,
'ExecutionType' => '<string>',
'NonCompliantCriticalCount' => <integer>,
'NonCompliantHighCount' => <integer>,
'NonCompliantInformationalCount' => <integer>,
'NonCompliantLowCount' => <integer>,
'NonCompliantMediumCount' => <integer>,
'NonCompliantUnspecifiedCount' => <integer>,
'OverallSeverity' => '<string>',
'PatchBaselineId' => '<string>',
'PatchGroup' => '<string>',
'Status' => '<string>',
],
],
],
'AwsWafWebAcl' => [
'DefaultAction' => '<string>',
'Name' => '<string>',
'Rules' => [
[
'Action' => [
'Type' => '<string>',
],
'ExcludedRules' => [
[
'RuleId' => '<string>',
],
// ...
],
'OverrideAction' => [
'Type' => '<string>',
],
'Priority' => <integer>,
'RuleId' => '<string>',
'Type' => '<string>',
],
// ...
],
'WebAclId' => '<string>',
],
'Container' => [
'ImageId' => '<string>',
'ImageName' => '<string>',
'LaunchedAt' => '<string>',
'Name' => '<string>',
],
'Other' => ['<string>', ...],
],
'Id' => '<string>',
'Partition' => 'aws|aws-cn|aws-us-gov',
'Region' => '<string>',
'ResourceRole' => '<string>',
'Tags' => ['<string>', ...],
'Type' => '<string>',
],
// ...
],
'SchemaVersion' => '<string>',
'Severity' => [
'Label' => 'INFORMATIONAL|LOW|MEDIUM|HIGH|CRITICAL',
'Normalized' => <integer>,
'Original' => '<string>',
'Product' => <float>,
],
'SourceUrl' => '<string>',
'ThreatIntelIndicators' => [
[
'Category' => 'BACKDOOR|CARD_STEALER|COMMAND_AND_CONTROL|DROP_SITE|EXPLOIT_SITE|KEYLOGGER',
'LastObservedAt' => '<string>',
'Source' => '<string>',
'SourceUrl' => '<string>',
'Type' => 'DOMAIN|EMAIL_ADDRESS|HASH_MD5|HASH_SHA1|HASH_SHA256|HASH_SHA512|IPV4_ADDRESS|IPV6_ADDRESS|MUTEX|PROCESS|URL',
'Value' => '<string>',
],
// ...
],
'Title' => '<string>',
'Types' => ['<string>', ...],
'UpdatedAt' => '<string>',
'UserDefinedFields' => ['<string>', ...],
'VerificationState' => 'UNKNOWN|TRUE_POSITIVE|FALSE_POSITIVE|BENIGN_POSITIVE',
'Vulnerabilities' => [
[
'Cvss' => [
[
'BaseScore' => <float>,
'BaseVector' => '<string>',
'Version' => '<string>',
],
// ...
],
'Id' => '<string>',
'ReferenceUrls' => ['<string>', ...],
'RelatedVulnerabilities' => ['<string>', ...],
'Vendor' => [
'Name' => '<string>',
'Url' => '<string>',
'VendorCreatedAt' => '<string>',
'VendorSeverity' => '<string>',
'VendorUpdatedAt' => '<string>',
],
'VulnerablePackages' => [
[
'Architecture' => '<string>',
'Epoch' => '<string>',
'Name' => '<string>',
'Release' => '<string>',
'Version' => '<string>',
],
// ...
],
],
// ...
],
'Workflow' => [
'Status' => 'NEW|NOTIFIED|RESOLVED|SUPPRESSED',
],
'WorkflowState' => 'NEW|ASSIGNED|IN_PROGRESS|DEFERRED|RESOLVED',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- Findings
-
- Required: Yes
- Type: Array of AwsSecurityFinding structures
The findings that matched the filters specified in the request.
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
GetInsightResults
$result = $client->getInsightResults([/* ... */]); $promise = $client->getInsightResultsAsync([/* ... */]);
Lists the results of the Security Hub insight specified by the insight ARN.
Parameter Syntax
$result = $client->getInsightResults([
'InsightArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'InsightResults' => [
'GroupByAttribute' => '<string>',
'InsightArn' => '<string>',
'ResultValues' => [
[
'Count' => <integer>,
'GroupByAttributeValue' => '<string>',
],
// ...
],
],
]
Result Details
Members
- InsightResults
-
- Required: Yes
- Type: InsightResults structure
The insight results returned by the operation.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
GetInsights
$result = $client->getInsights([/* ... */]); $promise = $client->getInsightsAsync([/* ... */]);
Lists and describes insights for the specified insight ARNs.
Parameter Syntax
$result = $client->getInsights([
'InsightArns' => ['<string>', ...],
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
- InsightArns
-
- Type: Array of strings
The ARNs of the insights to describe. If you do not provide any insight ARNs, then
GetInsightsreturns all of your custom insights. It does not return any managed insights. - MaxResults
-
- Type: int
The maximum number of items to return in the response.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
GetInsightsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
Result Syntax
[
'Insights' => [
[
'Filters' => [
'AwsAccountId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'CompanyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ComplianceStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Confidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'CreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'Criticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'Description' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsConfidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsCriticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsRelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsRelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityOriginal' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsTypes' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FirstObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'GeneratorId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Id' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Keyword' => [
[
'Value' => '<string>',
],
// ...
],
'LastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'MalwareName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwarePath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationPort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NetworkDirection' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkProtocol' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceMac' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourcePort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NoteText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NoteUpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'NoteUpdatedBy' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProcessName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessParentPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessPath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessTerminatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProductFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ProductName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecommendationText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecordState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIamInstanceProfileArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV4Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV6Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceKeyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceSubnetId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceVpcId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyCreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyPrincipalName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamUserUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceContainerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceDetailsOther' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourcePartition' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceRegion' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceTags' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityNormalized' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SeverityProduct' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorCategory' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorLastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSource' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorValue' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Title' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Type' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'UpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'UserDefinedFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'VerificationState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
],
'GroupByAttribute' => '<string>',
'InsightArn' => '<string>',
'Name' => '<string>',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- Insights
-
- Required: Yes
- Type: Array of Insight structures
The insights returned by the operation.
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
GetInvitationsCount
$result = $client->getInvitationsCount([/* ... */]); $promise = $client->getInvitationsCountAsync([/* ... */]);
Returns the count of all Security Hub membership invitations that were sent to the current member account, not including the currently accepted invitation.
Parameter Syntax
$result = $client->getInvitationsCount([ ]);
Parameter Details
Members
Result Syntax
[
'InvitationsCount' => <integer>,
]
Result Details
Members
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
GetMasterAccount
$result = $client->getMasterAccount([/* ... */]); $promise = $client->getMasterAccountAsync([/* ... */]);
This method is deprecated. Instead, use GetAdministratorAccount.
The Security Hub console continues to use GetMasterAccount. It will eventually change to use GetAdministratorAccount. Any IAM policies that specifically control access to this function must continue to use GetMasterAccount. You should also add GetAdministratorAccount to your policies to ensure that the correct permissions are in place after the console begins to use GetAdministratorAccount.
Provides the details for the Security Hub administrator account for the current member account.
Can be used by both member accounts that are managed using Organizations and accounts that were invited manually.
Parameter Syntax
$result = $client->getMasterAccount([ ]);
Parameter Details
Members
Result Syntax
[
'Master' => [
'AccountId' => '<string>',
'InvitationId' => '<string>',
'InvitedAt' => <DateTime>,
'MemberStatus' => '<string>',
],
]
Result Details
Members
- Master
-
- Type: Invitation structure
A list of details about the Security Hub administrator account for the current member account.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
GetMembers
$result = $client->getMembers([/* ... */]); $promise = $client->getMembersAsync([/* ... */]);
Returns the details for the Security Hub member accounts for the specified account IDs.
An administrator account can be either the delegated Security Hub administrator account for an organization or an administrator account that enabled Security Hub manually.
The results include both member accounts that are managed using Organizations and accounts that were invited manually.
Parameter Syntax
$result = $client->getMembers([
'AccountIds' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'Members' => [
[
'AccountId' => '<string>',
'AdministratorId' => '<string>',
'Email' => '<string>',
'InvitedAt' => <DateTime>,
'MasterId' => '<string>',
'MemberStatus' => '<string>',
'UpdatedAt' => <DateTime>,
],
// ...
],
'UnprocessedAccounts' => [
[
'AccountId' => '<string>',
'ProcessingResult' => '<string>',
],
// ...
],
]
Result Details
Members
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
InviteMembers
$result = $client->inviteMembers([/* ... */]); $promise = $client->inviteMembersAsync([/* ... */]);
Invites other Amazon Web Services accounts to become member accounts for the Security Hub administrator account that the invitation is sent from.
This operation is only used to invite accounts that do not belong to an organization. Organization accounts do not receive invitations.
Before you can use this action to invite a member, you must first use the CreateMembers action to create the member account in Security Hub.
When the account owner enables Security Hub and accepts the invitation to become a member account, the administrator account can view the findings generated from the member account.
Parameter Syntax
$result = $client->inviteMembers([
'AccountIds' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'UnprocessedAccounts' => [
[
'AccountId' => '<string>',
'ProcessingResult' => '<string>',
],
// ...
],
]
Result Details
Members
- UnprocessedAccounts
-
- Type: Array of Result structures
The list of Amazon Web Services accounts that could not be processed. For each account, the list includes the account ID and the email address.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
ListEnabledProductsForImport
$result = $client->listEnabledProductsForImport([/* ... */]); $promise = $client->listEnabledProductsForImportAsync([/* ... */]);
Lists all findings-generating solutions (products) that you are subscribed to receive findings from in Security Hub.
Parameter Syntax
$result = $client->listEnabledProductsForImport([
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of items to return in the response.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
ListEnabledProductsForImportoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
Result Syntax
[
'NextToken' => '<string>',
'ProductSubscriptions' => ['<string>', ...],
]
Result Details
Members
Errors
-
Internal server error.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
ListInvitations
$result = $client->listInvitations([/* ... */]); $promise = $client->listInvitationsAsync([/* ... */]);
Lists all Security Hub membership invitations that were sent to the current Amazon Web Services account.
This operation is only used by accounts that are managed by invitation. Accounts that are managed using the integration with Organizations do not receive invitations.
Parameter Syntax
$result = $client->listInvitations([
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of items to return in the response.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
ListInvitationsoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
Result Syntax
[
'Invitations' => [
[
'AccountId' => '<string>',
'InvitationId' => '<string>',
'InvitedAt' => <DateTime>,
'MemberStatus' => '<string>',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- Invitations
-
- Type: Array of Invitation structures
The details of the invitations returned by the operation.
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
ListMembers
$result = $client->listMembers([/* ... */]); $promise = $client->listMembersAsync([/* ... */]);
Lists details about all member accounts for the current Security Hub administrator account.
The results include both member accounts that belong to an organization and member accounts that were invited manually.
Parameter Syntax
$result = $client->listMembers([
'MaxResults' => <integer>,
'NextToken' => '<string>',
'OnlyAssociated' => true || false,
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of items to return in the response.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
ListMembersoperation, set the value of this parameter toNULL.For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
- OnlyAssociated
-
- Type: boolean
Specifies which member accounts to include in the response based on their relationship status with the administrator account. The default value is
TRUE.If
OnlyAssociatedis set toTRUE, the response includes member accounts whose relationship status with the administrator account is set toENABLED.If
OnlyAssociatedis set toFALSE, the response includes all existing member accounts.
Result Syntax
[
'Members' => [
[
'AccountId' => '<string>',
'AdministratorId' => '<string>',
'Email' => '<string>',
'InvitedAt' => <DateTime>,
'MasterId' => '<string>',
'MemberStatus' => '<string>',
'UpdatedAt' => <DateTime>,
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- Members
-
- Type: Array of Member structures
Member details returned by the operation.
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
ListOrganizationAdminAccounts
$result = $client->listOrganizationAdminAccounts([/* ... */]); $promise = $client->listOrganizationAdminAccountsAsync([/* ... */]);
Lists the Security Hub administrator accounts. Can only be called by the organization management account.
Parameter Syntax
$result = $client->listOrganizationAdminAccounts([
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of items to return in the response.
- NextToken
-
- Type: string
The token that is required for pagination. On your first call to the
ListOrganizationAdminAccountsoperation, set the value of this parameter toNULL. For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
Result Syntax
[
'AdminAccounts' => [
[
'AccountId' => '<string>',
'Status' => 'ENABLED|DISABLE_IN_PROGRESS',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- AdminAccounts
-
- Type: Array of AdminAccount structures
The list of Security Hub administrator accounts.
- NextToken
-
- Type: string
The pagination token to use to request the next page of results.
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
ListTagsForResource
$result = $client->listTagsForResource([/* ... */]); $promise = $client->listTagsForResourceAsync([/* ... */]);
Returns a list of tags associated with a resource.
Parameter Syntax
$result = $client->listTagsForResource([
'ResourceArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'Tags' => ['<string>', ...],
]
Result Details
Members
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because we can't find the specified resource.
TagResource
$result = $client->tagResource([/* ... */]); $promise = $client->tagResourceAsync([/* ... */]);
Adds one or more tags to a resource.
Parameter Syntax
$result = $client->tagResource([
'ResourceArn' => '<string>', // REQUIRED
'Tags' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
- ResourceArn
-
- Required: Yes
- Type: string
The ARN of the resource to apply the tags to.
- Tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
The tags to add to the resource. You can add up to 50 tags at a time. The tag keys can be no longer than 128 characters. The tag values can be no longer than 256 characters.
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because we can't find the specified resource.
UntagResource
$result = $client->untagResource([/* ... */]); $promise = $client->untagResourceAsync([/* ... */]);
Removes one or more tags from a resource.
Parameter Syntax
$result = $client->untagResource([
'ResourceArn' => '<string>', // REQUIRED
'TagKeys' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because we can't find the specified resource.
UpdateActionTarget
$result = $client->updateActionTarget([/* ... */]); $promise = $client->updateActionTargetAsync([/* ... */]);
Updates the name and description of a custom action target in Security Hub.
Parameter Syntax
$result = $client->updateActionTarget([
'ActionTargetArn' => '<string>', // REQUIRED
'Description' => '<string>',
'Name' => '<string>',
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because we can't find the specified resource.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
UpdateFindings
$result = $client->updateFindings([/* ... */]); $promise = $client->updateFindingsAsync([/* ... */]);
UpdateFindings is deprecated. Instead of UpdateFindings, use BatchUpdateFindings.
Updates the Note and RecordState of the Security Hub-aggregated findings that the filter attributes specify. Any member account that can view the finding also sees the update to the finding.
Parameter Syntax
$result = $client->updateFindings([
'Filters' => [ // REQUIRED
'AwsAccountId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'CompanyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ComplianceStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Confidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'CreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'Criticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'Description' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsConfidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsCriticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsRelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsRelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityOriginal' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsTypes' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FirstObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'GeneratorId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Id' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Keyword' => [
[
'Value' => '<string>',
],
// ...
],
'LastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'MalwareName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwarePath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationPort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NetworkDirection' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkProtocol' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceMac' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourcePort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NoteText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NoteUpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'NoteUpdatedBy' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProcessName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessParentPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessPath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessTerminatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProductFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ProductName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecommendationText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecordState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIamInstanceProfileArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV4Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV6Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceKeyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceSubnetId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceVpcId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyCreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyPrincipalName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamUserUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceContainerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceDetailsOther' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourcePartition' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceRegion' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceTags' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityNormalized' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SeverityProduct' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorCategory' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorLastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSource' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorValue' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Title' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Type' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'UpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'UserDefinedFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'VerificationState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
],
'Note' => [
'Text' => '<string>', // REQUIRED
'UpdatedBy' => '<string>', // REQUIRED
],
'RecordState' => 'ACTIVE|ARCHIVED',
]);
Parameter Details
Members
- Filters
-
- Required: Yes
- Type: AwsSecurityFindingFilters structure
A collection of attributes that specify which findings you want to update.
- Note
-
- Type: NoteUpdate structure
The updated note for the finding.
- RecordState
-
- Type: string
The updated record state for the finding.
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
UpdateInsight
$result = $client->updateInsight([/* ... */]); $promise = $client->updateInsightAsync([/* ... */]);
Updates the Security Hub insight identified by the specified insight ARN.
Parameter Syntax
$result = $client->updateInsight([
'Filters' => [
'AwsAccountId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'CompanyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ComplianceStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Confidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'CreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'Criticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'Description' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsConfidence' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsCriticality' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'FindingProviderFieldsRelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsRelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsSeverityOriginal' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FindingProviderFieldsTypes' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'FirstObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'GeneratorId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Id' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Keyword' => [
[
'Value' => '<string>',
],
// ...
],
'LastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'MalwareName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwarePath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'MalwareType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkDestinationIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkDestinationPort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NetworkDirection' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkProtocol' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceDomain' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourceIpV4' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceIpV6' => [
[
'Cidr' => '<string>',
],
// ...
],
'NetworkSourceMac' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NetworkSourcePort' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'NoteText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'NoteUpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'NoteUpdatedBy' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProcessName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessParentPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessPath' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProcessPid' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'ProcessTerminatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ProductFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ProductName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecommendationText' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RecordState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'RelatedFindingsProductArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIamInstanceProfileArn' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV4Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceIpV6Addresses' => [
[
'Cidr' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceKeyName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceSubnetId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsEc2InstanceVpcId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyCreatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyPrincipalName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamAccessKeyUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsIamUserUserName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceAwsS3BucketOwnerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerImageName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceContainerLaunchedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ResourceContainerName' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceDetailsOther' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceId' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourcePartition' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceRegion' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ResourceTags' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'ResourceType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityLabel' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'SeverityNormalized' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SeverityProduct' => [
[
'Eq' => <float>,
'Gte' => <float>,
'Lte' => <float>,
],
// ...
],
'SourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorCategory' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorLastObservedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSource' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorSourceUrl' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorType' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'ThreatIntelIndicatorValue' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Title' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'Type' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'UpdatedAt' => [
[
'DateRange' => [
'Unit' => 'DAYS',
'Value' => <integer>,
],
'End' => '<string>',
'Start' => '<string>',
],
// ...
],
'UserDefinedFields' => [
[
'Comparison' => 'EQUALS|NOT_EQUALS',
'Key' => '<string>',
'Value' => '<string>',
],
// ...
],
'VerificationState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowState' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
'WorkflowStatus' => [
[
'Comparison' => 'EQUALS|PREFIX|NOT_EQUALS|PREFIX_NOT_EQUALS',
'Value' => '<string>',
],
// ...
],
],
'GroupByAttribute' => '<string>',
'InsightArn' => '<string>', // REQUIRED
'Name' => '<string>',
]);
Parameter Details
Members
- Filters
-
- Type: AwsSecurityFindingFilters structure
The updated filters that define this insight.
- GroupByAttribute
-
- Type: string
The updated
GroupByattribute that defines this insight. - InsightArn
-
- Required: Yes
- Type: string
The ARN of the insight that you want to update.
- Name
-
- Type: string
The updated name for the insight.
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
UpdateOrganizationConfiguration
$result = $client->updateOrganizationConfiguration([/* ... */]); $promise = $client->updateOrganizationConfigurationAsync([/* ... */]);
Used to update the configuration related to Organizations. Can only be called from a Security Hub administrator account.
Parameter Syntax
$result = $client->updateOrganizationConfiguration([
'AutoEnable' => true || false, // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
UpdateSecurityHubConfiguration
$result = $client->updateSecurityHubConfiguration([/* ... */]); $promise = $client->updateSecurityHubConfigurationAsync([/* ... */]);
Updates configuration options for Security Hub.
Parameter Syntax
$result = $client->updateSecurityHubConfiguration([
'AutoEnableControls' => true || false,
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because it attempted to create resources beyond the current Amazon Web Services account or throttling limits. The error code describes the limit exceeded.
-
The request was rejected because we can't find the specified resource.
UpdateStandardsControl
$result = $client->updateStandardsControl([/* ... */]); $promise = $client->updateStandardsControlAsync([/* ... */]);
Used to control whether an individual security standard control is enabled or disabled.
Parameter Syntax
$result = $client->updateStandardsControl([
'ControlStatus' => 'ENABLED|DISABLED',
'DisabledReason' => '<string>',
'StandardsControlArn' => '<string>', // REQUIRED
]);
Parameter Details
Members
- ControlStatus
-
- Type: string
The updated status of the security standard control.
- DisabledReason
-
- Type: string
A description of the reason why you are disabling a security standard control. If you are disabling a control, then this is required.
- StandardsControlArn
-
- Required: Yes
- Type: string
The ARN of the security standard control to enable or disable.
Result Syntax
[]
Result Details
Errors
-
Internal server error.
-
The request was rejected because you supplied an invalid or out-of-range value for an input parameter.
-
There is an issue with the account used to make the request. Either Security Hub is not enabled for the account, or the account does not have permission to perform this action.
-
The request was rejected because we can't find the specified resource.
Shapes
AccessDeniedException
Description
You don't have permission to perform the action specified in the request.
Members
AccountDetails
Description
The details of an Amazon Web Services account.
Members
Action
Description
Provides details about one of the following actions that affects or that was taken on a resource:
-
A remote IP address issued an Amazon Web Services API call
-
A DNS request was received
-
A remote IP address attempted to connect to an EC2 instance
-
A remote IP address attempted a port probe on an EC2 instance
Members
- ActionType
-
- Type: string
The type of action that was detected. The possible action types are:
-
NETWORK_CONNECTION -
AWS_API_CALL -
DNS_REQUEST -
PORT_PROBE
- AwsApiCallAction
-
- Type: AwsApiCallAction structure
Included if
ActionTypeisAWS_API_CALL. Provides details about the API call that was detected. - DnsRequestAction
-
- Type: DnsRequestAction structure
Included if
ActionTypeisDNS_REQUEST. Provides details about the DNS request that was detected. - NetworkConnectionAction
-
- Type: NetworkConnectionAction structure
Included if
ActionTypeisNETWORK_CONNECTION. Provides details about the network connection that was detected. - PortProbeAction
-
- Type: PortProbeAction structure
Included if
ActionTypeisPORT_PROBE. Provides details about the port probe that was detected.
ActionLocalIpDetails
Description
Provides information about the IP address where the scanned port is located.
Members
ActionLocalPortDetails
Description
For NetworkConnectionAction and PortProbeDetails, LocalPortDetails provides information about the local port that was involved in the action.
Members
ActionRemoteIpDetails
Description
For AwsApiAction, NetworkConnectionAction, and PortProbeAction, RemoteIpDetails provides information about the remote IP address that was involved in the action.
Members
- City
-
- Type: City structure
The city where the remote IP address is located.
- Country
-
- Type: Country structure
The country where the remote IP address is located.
- GeoLocation
-
- Type: GeoLocation structure
The coordinates of the location of the remote IP address.
- IpAddressV4
-
- Type: string
The IP address.
- Organization
-
- Type: IpOrganizationDetails structure
The internet service provider (ISP) organization associated with the remote IP address.
ActionRemotePortDetails
Description
Provides information about the remote port that was involved in an attempted network connection.
Members
ActionTarget
Description
An ActionTarget object.
Members
AdminAccount
Description
Represents a Security Hub administrator account designated by an organization management account.
Members
AvailabilityZone
Description
Information about an Availability Zone.
Members
AwsApiCallAction
Description
Provided if ActionType is AWS_API_CALL. It provides details about the API call that was detected.
Members
- AffectedResources
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
Identifies the resources that were affected by the API call.
- Api
-
- Type: string
The name of the API method that was issued.
- CallerType
-
- Type: string
Indicates whether the API call originated from a remote IP address (
remoteip) or from a DNS domain (domain). - DomainDetails
-
- Type: AwsApiCallActionDomainDetails structure
Provided if
CallerTypeisdomain. Provides information about the DNS domain that the API call originated from. - FirstSeen
-
- Type: string
An ISO8601-formatted timestamp that indicates when the API call was first observed.
- LastSeen
-
- Type: string
An ISO8601-formatted timestamp that indicates when the API call was most recently observed.
- RemoteIpDetails
-
- Type: ActionRemoteIpDetails structure
Provided if
CallerTypeisremoteIp. Provides information about the remote IP address that the API call originated from. - ServiceName
-
- Type: string
The name of the Amazon Web Services service that the API method belongs to.
AwsApiCallActionDomainDetails
Description
Provided if CallerType is domain. It provides information about the DNS domain that issued the API call.
Members
AwsApiGatewayAccessLogSettings
Description
Contains information about settings for logging access for the stage.
Members
AwsApiGatewayCanarySettings
Description
Contains information about settings for canary deployment in the stage.
Members
- DeploymentId
-
- Type: string
The deployment identifier for the canary deployment.
- PercentTraffic
-
- Type: double
The percentage of traffic that is diverted to a canary deployment.
- StageVariableOverrides
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
Stage variables that are overridden in the canary release deployment. The variables include new stage variables that are introduced in the canary.
Each variable is represented as a string-to-string map between the stage variable name and the variable value.
- UseStageCache
-
- Type: boolean
Indicates whether the canary deployment uses the stage cache.
AwsApiGatewayEndpointConfiguration
Description
Contains information about the endpoints for the API.
Members
AwsApiGatewayMethodSettings
Description
Defines settings for a method for the stage.
Members
- CacheDataEncrypted
-
- Type: boolean
Indicates whether the cached responses are encrypted.
- CacheTtlInSeconds
-
- Type: int
Specifies the time to live (TTL), in seconds, for cached responses. The higher the TTL, the longer the response is cached.
- CachingEnabled
-
- Type: boolean
Indicates whether responses are cached and returned for requests. For responses to be cached, a cache cluster must be enabled on the stage.
- DataTraceEnabled
-
- Type: boolean
Indicates whether data trace logging is enabled for the method. Data trace logging affects the log entries that are pushed to CloudWatch Logs.
- HttpMethod
-
- Type: string
The HTTP method. You can use an asterisk (*) as a wildcard to apply method settings to multiple methods.
- LoggingLevel
-
- Type: string
The logging level for this method. The logging level affects the log entries that are pushed to CloudWatch Logs.
If the logging level is
ERROR, then the logs only include error-level entries.If the logging level is
INFO, then the logs include bothERRORevents and extra informational events.Valid values:
OFF|ERROR|INFO - MetricsEnabled
-
- Type: boolean
Indicates whether CloudWatch metrics are enabled for the method.
- RequireAuthorizationForCacheControl
-
- Type: boolean
Indicates whether authorization is required for a cache invalidation request.
- ResourcePath
-
- Type: string
The resource path for this method. Forward slashes (/) are encoded as ~1 . The initial slash must include a forward slash.
For example, the path value
/resource/subresourcemust be encoded as/~1resource~1subresource.To specify the root path, use only a slash (/). You can use an asterisk (*) as a wildcard to apply method settings to multiple methods.
- ThrottlingBurstLimit
-
- Type: int
The throttling burst limit for the method.
- ThrottlingRateLimit
-
- Type: double
The throttling rate limit for the method.
- UnauthorizedCacheControlHeaderStrategy
-
- Type: string
Indicates how to handle unauthorized requests for cache invalidation.
Valid values:
FAIL_WITH_403|SUCCEED_WITH_RESPONSE_HEADER|SUCCEED_WITHOUT_RESPONSE_HEADER
AwsApiGatewayRestApiDetails
Description
Contains information about a REST API in version 1 of Amazon API Gateway.
Members
- ApiKeySource
-
- Type: string
The source of the API key for metering requests according to a usage plan.
HEADERindicates whether to read the API key from the X-API-Key header of a request.AUTHORIZERindicates whether to read the API key from theUsageIdentifierKeyfrom a custom authorizer. - BinaryMediaTypes
-
- Type: Array of strings
The list of binary media types supported by the REST API.
- CreatedDate
-
- Type: string
Indicates when the API was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - Description
-
- Type: string
A description of the REST API.
- EndpointConfiguration
-
- Type: AwsApiGatewayEndpointConfiguration structure
The endpoint configuration of the REST API.
- Id
-
- Type: string
The identifier of the REST API.
- MinimumCompressionSize
-
- Type: int
The minimum size in bytes of a payload before compression is enabled.
If
null, then compression is disabled.If 0, then all payloads are compressed.
- Name
-
- Type: string
The name of the REST API.
- Version
-
- Type: string
The version identifier for the REST API.
AwsApiGatewayStageDetails
Description
Provides information about a version 1 Amazon API Gateway stage.
Members
- AccessLogSettings
-
- Type: AwsApiGatewayAccessLogSettings structure
Settings for logging access for the stage.
- CacheClusterEnabled
-
- Type: boolean
Indicates whether a cache cluster is enabled for the stage.
- CacheClusterSize
-
- Type: string
If a cache cluster is enabled, the size of the cache cluster.
- CacheClusterStatus
-
- Type: string
If a cache cluster is enabled, the status of the cache cluster.
- CanarySettings
-
- Type: AwsApiGatewayCanarySettings structure
Information about settings for canary deployment in the stage.
- ClientCertificateId
-
- Type: string
The identifier of the client certificate for the stage.
- CreatedDate
-
- Type: string
Indicates when the stage was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - DeploymentId
-
- Type: string
The identifier of the deployment that the stage points to.
- Description
-
- Type: string
A description of the stage.
- DocumentationVersion
-
- Type: string
The version of the API documentation that is associated with the stage.
- LastUpdatedDate
-
- Type: string
Indicates when the stage was most recently updated.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - MethodSettings
-
- Type: Array of AwsApiGatewayMethodSettings structures
Defines the method settings for the stage.
- StageName
-
- Type: string
The name of the stage.
- TracingEnabled
-
- Type: boolean
Indicates whether active tracing with X-Ray is enabled for the stage.
- Variables
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A map that defines the stage variables for the stage.
Variable names can have alphanumeric and underscore characters.
Variable values can contain the following characters:
-
Uppercase and lowercase letters
-
Numbers
-
Special characters -._~:/?#&=,
- WebAclArn
-
- Type: string
The ARN of the web ACL associated with the stage.
AwsApiGatewayV2ApiDetails
Description
Contains information about a version 2 API in Amazon API Gateway.
Members
- ApiEndpoint
-
- Type: string
The URI of the API.
Uses the format
<api-id>.execute-api.<region>.amazonaws.comThe stage name is typically appended to the URI to form a complete path to a deployed API stage.
- ApiId
-
- Type: string
The identifier of the API.
- ApiKeySelectionExpression
-
- Type: string
An API key selection expression. Supported only for WebSocket APIs.
- CorsConfiguration
-
- Type: AwsCorsConfiguration structure
A cross-origin resource sharing (CORS) configuration. Supported only for HTTP APIs.
- CreatedDate
-
- Type: string
Indicates when the API was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - Description
-
- Type: string
A description of the API.
- Name
-
- Type: string
The name of the API.
- ProtocolType
-
- Type: string
The API protocol for the API.
Valid values:
WEBSOCKET|HTTP - RouteSelectionExpression
-
- Type: string
The route selection expression for the API.
For HTTP APIs, must be
${request.method} ${request.path}. This is the default value for HTTP APIs.For WebSocket APIs, there is no default value.
- Version
-
- Type: string
The version identifier for the API.
AwsApiGatewayV2RouteSettings
Description
Contains route settings for a stage.
Members
- DataTraceEnabled
-
- Type: boolean
Indicates whether data trace logging is enabled. Data trace logging affects the log entries that are pushed to CloudWatch Logs. Supported only for WebSocket APIs.
- DetailedMetricsEnabled
-
- Type: boolean
Indicates whether detailed metrics are enabled.
- LoggingLevel
-
- Type: string
The logging level. The logging level affects the log entries that are pushed to CloudWatch Logs. Supported only for WebSocket APIs.
If the logging level is
ERROR, then the logs only include error-level entries.If the logging level is
INFO, then the logs include bothERRORevents and extra informational events.Valid values:
OFF|ERROR|INFO - ThrottlingBurstLimit
-
- Type: int
The throttling burst limit.
- ThrottlingRateLimit
-
- Type: double
The throttling rate limit.
AwsApiGatewayV2StageDetails
Description
Contains information about a version 2 stage for Amazon API Gateway.
Members
- AccessLogSettings
-
- Type: AwsApiGatewayAccessLogSettings structure
Information about settings for logging access for the stage.
- ApiGatewayManaged
-
- Type: boolean
Indicates whether the stage is managed by API Gateway.
- AutoDeploy
-
- Type: boolean
Indicates whether updates to an API automatically trigger a new deployment.
- ClientCertificateId
-
- Type: string
The identifier of a client certificate for a stage. Supported only for WebSocket API calls.
- CreatedDate
-
- Type: string
Indicates when the stage was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - DefaultRouteSettings
-
- Type: AwsApiGatewayV2RouteSettings structure
Default route settings for the stage.
- DeploymentId
-
- Type: string
The identifier of the deployment that the stage is associated with.
- Description
-
- Type: string
The description of the stage.
- LastDeploymentStatusMessage
-
- Type: string
The status of the last deployment of a stage. Supported only if the stage has automatic deployment enabled.
- LastUpdatedDate
-
- Type: string
Indicates when the stage was most recently updated.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - RouteSettings
-
- Type: AwsApiGatewayV2RouteSettings structure
The route settings for the stage.
- StageName
-
- Type: string
The name of the stage.
- StageVariables
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A map that defines the stage variables for the stage.
Variable names can have alphanumeric and underscore characters.
Variable values can contain the following characters:
-
Uppercase and lowercase letters
-
Numbers
-
Special characters -._~:/?#&=,
AwsAutoScalingAutoScalingGroupDetails
Description
Provides details about an auto scaling group.
Members
- CreatedTime
-
- Type: string
Indicates when the auto scaling group was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - HealthCheckGracePeriod
-
- Type: int
The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before it checks the health status of an EC2 instance that has come into service.
- HealthCheckType
-
- Type: string
The service to use for the health checks.
- LaunchConfigurationName
-
- Type: string
The name of the launch configuration.
- LoadBalancerNames
-
- Type: Array of strings
The list of load balancers associated with the group.
AwsCertificateManagerCertificateDetails
Description
Provides details about an Certificate Manager certificate.
Members
- CertificateAuthorityArn
-
- Type: string
The ARN of the private certificate authority (CA) that will be used to issue the certificate.
- CreatedAt
-
- Type: string
Indicates when the certificate was requested.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - DomainName
-
- Type: string
The fully qualified domain name (FQDN), such as www.example.com, that is secured by the certificate.
- DomainValidationOptions
-
- Type: Array of AwsCertificateManagerCertificateDomainValidationOption structures
Contains information about the initial validation of each domain name that occurs as a result of the
RequestCertificaterequest.Only provided if the certificate type is
AMAZON_ISSUED. - ExtendedKeyUsages
-
- Type: Array of AwsCertificateManagerCertificateExtendedKeyUsage structures
Contains a list of Extended Key Usage X.509 v3 extension objects. Each object specifies a purpose for which the certificate public key can be used and consists of a name and an object identifier (OID).
- FailureReason
-
- Type: string
For a failed certificate request, the reason for the failure.
Valid values:
NO_AVAILABLE_CONTACTS|ADDITIONAL_VERIFICATION_REQUIRED|DOMAIN_NOT_ALLOWED|INVALID_PUBLIC_DOMAIN|DOMAIN_VALIDATION_DENIED|CAA_ERROR|PCA_LIMIT_EXCEEDED|PCA_INVALID_ARN|PCA_INVALID_STATE|PCA_REQUEST_FAILED|PCA_NAME_CONSTRAINTS_VALIDATION|PCA_RESOURCE_NOT_FOUND|PCA_INVALID_ARGS|PCA_INVALID_DURATION|PCA_ACCESS_DENIED|SLR_NOT_FOUND|OTHER - ImportedAt
-
- Type: string
Indicates when the certificate was imported. Provided if the certificate type is
IMPORTED.Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - InUseBy
-
- Type: Array of strings
The list of ARNs for the Amazon Web Services resources that use the certificate.
- IssuedAt
-
- Type: string
Indicates when the certificate was issued. Provided if the certificate type is
AMAZON_ISSUED.Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - Issuer
-
- Type: string
The name of the certificate authority that issued and signed the certificate.
- KeyAlgorithm
-
- Type: string
The algorithm that was used to generate the public-private key pair.
Valid values:
RSA_2048|RSA_1024|RSA_4096|EC_prime256v1|EC_secp384r1|EC_secp521r1 - KeyUsages
-
- Type: Array of AwsCertificateManagerCertificateKeyUsage structures
A list of key usage X.509 v3 extension objects.
- NotAfter
-
- Type: string
The time after which the certificate becomes invalid.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - NotBefore
-
- Type: string
The time before which the certificate is not valid.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - Options
-
- Type: AwsCertificateManagerCertificateOptions structure
Provides a value that specifies whether to add the certificate to a transparency log.
- RenewalEligibility
-
- Type: string
Whether the certificate is eligible for renewal.
Valid values:
ELIGIBLE|INELIGIBLE - RenewalSummary
-
- Type: AwsCertificateManagerCertificateRenewalSummary structure
Information about the status of the Certificate Manager managed renewal for the certificate. Provided only when the certificate type is
AMAZON_ISSUED. - Serial
-
- Type: string
The serial number of the certificate.
- SignatureAlgorithm
-
- Type: string
The algorithm that was used to sign the certificate.
- Status
-
- Type: string
The status of the certificate.
Valid values:
PENDING_VALIDATION|ISSUED|INACTIVE|EXPIRED|VALIDATION_TIMED_OUT|REVOKED|FAILED - Subject
-
- Type: string
The name of the entity that is associated with the public key contained in the certificate.
- SubjectAlternativeNames
-
- Type: Array of strings
One or more domain names (subject alternative names) included in the certificate. This list contains the domain names that are bound to the public key that is contained in the certificate.
The subject alternative names include the canonical domain name (CN) of the certificate and additional domain names that can be used to connect to the website.
- Type
-
- Type: string
The source of the certificate. For certificates that Certificate Manager provides,
TypeisAMAZON_ISSUED. For certificates that are imported withImportCertificate,TypeisIMPORTED.Valid values:
IMPORTED|AMAZON_ISSUED|PRIVATE
AwsCertificateManagerCertificateDomainValidationOption
Description
Contains information about one of the following:
-
The initial validation of each domain name that occurs as a result of the
RequestCertificaterequest -
The validation of each domain name in the certificate, as it pertains to Certificate Manager managed renewal
Members
- DomainName
-
- Type: string
A fully qualified domain name (FQDN) in the certificate.
- ResourceRecord
-
- Type: AwsCertificateManagerCertificateResourceRecord structure
The CNAME record that is added to the DNS database for domain validation.
- ValidationDomain
-
- Type: string
The domain name that Certificate Manager uses to send domain validation emails.
- ValidationEmails
-
- Type: Array of strings
A list of email addresses that Certificate Manager uses to send domain validation emails.
- ValidationMethod
-
- Type: string
The method used to validate the domain name.
- ValidationStatus
-
- Type: string
The validation status of the domain name.
AwsCertificateManagerCertificateExtendedKeyUsage
Description
Contains information about an extended key usage X.509 v3 extension object.
Members
AwsCertificateManagerCertificateKeyUsage
Description
Contains information about a key usage X.509 v3 extension object.
Members
AwsCertificateManagerCertificateOptions
Description
Contains other options for the certificate.
Members
AwsCertificateManagerCertificateRenewalSummary
Description
Contains information about the Certificate Manager managed renewal for an AMAZON_ISSUED certificate.
Members
- DomainValidationOptions
-
- Type: Array of AwsCertificateManagerCertificateDomainValidationOption structures
Information about the validation of each domain name in the certificate, as it pertains to Certificate Manager managed renewal. Provided only when the certificate type is
AMAZON_ISSUED. - RenewalStatus
-
- Type: string
The status of the Certificate Manager managed renewal of the certificate.
Valid values:
PENDING_AUTO_RENEWAL|PENDING_VALIDATION|SUCCESS|FAILED - RenewalStatusReason
-
- Type: string
The reason that a renewal request was unsuccessful.
Valid values:
NO_AVAILABLE_CONTACTS|ADDITIONAL_VERIFICATION_REQUIRED|DOMAIN_NOT_ALLOWED|INVALID_PUBLIC_DOMAIN|DOMAIN_VALIDATION_DENIED|CAA_ERROR|PCA_LIMIT_EXCEEDED|PCA_INVALID_ARN|PCA_INVALID_STATE|PCA_REQUEST_FAILED|PCA_NAME_CONSTRAINTS_VALIDATION|PCA_RESOURCE_NOT_FOUND|PCA_INVALID_ARGS|PCA_INVALID_DURATION|PCA_ACCESS_DENIED|SLR_NOT_FOUND|OTHER - UpdatedAt
-
- Type: string
Indicates when the renewal summary was last updated.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z.
AwsCertificateManagerCertificateResourceRecord
Description
Provides details about the CNAME record that is added to the DNS database for domain validation.
Members
AwsCloudFrontDistributionCacheBehavior
Description
Information about a cache behavior for the distribution.
Members
- ViewerProtocolPolicy
-
- Type: string
The protocol that viewers can use to access the files in an origin. You can specify the following options:
-
allow-all- Viewers can use HTTP or HTTPS. -
redirect-to-https- CloudFront responds to HTTP requests with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL. The viewer then uses the new URL to resubmit. -
https-only- CloudFront responds to HTTP request with an HTTP status code of 403 (Forbidden).
AwsCloudFrontDistributionCacheBehaviors
Description
Provides information about caching for the distribution.
Members
- Items
-
- Type: Array of AwsCloudFrontDistributionCacheBehavior structures
The cache behaviors for the distribution.
AwsCloudFrontDistributionDefaultCacheBehavior
Description
Contains information about the default cache configuration for the distribution.
Members
- ViewerProtocolPolicy
-
- Type: string
The protocol that viewers can use to access the files in an origin. You can specify the following options:
-
allow-all- Viewers can use HTTP or HTTPS. -
redirect-to-https- CloudFront responds to HTTP requests with an HTTP status code of 301 (Moved Permanently) and the HTTPS URL. The viewer then uses the new URL to resubmit. -
https-only- CloudFront responds to HTTP request with an HTTP status code of 403 (Forbidden).
AwsCloudFrontDistributionDetails
Description
A distribution configuration.
Members
- CacheBehaviors
-
- Type: AwsCloudFrontDistributionCacheBehaviors structure
Provides information about the cache configuration for the distribution.
- DefaultCacheBehavior
-
- Type: AwsCloudFrontDistributionDefaultCacheBehavior structure
The default cache behavior for the configuration.
- DefaultRootObject
-
- Type: string
The object that CloudFront sends in response to requests from the origin (for example, index.html) when a viewer requests the root URL for the distribution (http://www.example.com) instead of an object in your distribution (http://www.example.com/product-description.html).
- DomainName
-
- Type: string
The domain name corresponding to the distribution.
- ETag
-
- Type: string
The entity tag is a hash of the object.
- LastModifiedTime
-
- Type: string
Indicates when that the distribution was last modified.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - Logging
-
- Type: AwsCloudFrontDistributionLogging structure
A complex type that controls whether access logs are written for the distribution.
- OriginGroups
-
- Type: AwsCloudFrontDistributionOriginGroups structure
Provides information about the origin groups in the distribution.
- Origins
-
- Type: AwsCloudFrontDistributionOrigins structure
A complex type that contains information about origins for this distribution.
- Status
-
- Type: string
Indicates the current status of the distribution.
- WebAclId
-
- Type: string
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution.
AwsCloudFrontDistributionLogging
Description
A complex type that controls whether access logs are written for the distribution.
Members
- Bucket
-
- Type: string
The S3 bucket to store the access logs in.
- Enabled
-
- Type: boolean
With this field, you can enable or disable the selected distribution.
- IncludeCookies
-
- Type: boolean
Specifies whether you want CloudFront to include cookies in access logs.
- Prefix
-
- Type: string
An optional string that you want CloudFront to use as a prefix to the access log filenames for this distribution.
AwsCloudFrontDistributionOriginGroup
Description
Information about an origin group for the distribution.
Members
- FailoverCriteria
-
- Type: AwsCloudFrontDistributionOriginGroupFailover structure
Provides the criteria for an origin group to fail over.
AwsCloudFrontDistributionOriginGroupFailover
Description
Provides information about when an origin group fails over.
Members
- StatusCodes
-
- Type: AwsCloudFrontDistributionOriginGroupFailoverStatusCodes structure
Information about the status codes that cause an origin group to fail over.
AwsCloudFrontDistributionOriginGroupFailoverStatusCodes
Description
The status codes that cause an origin group to fail over.
Members
AwsCloudFrontDistributionOriginGroups
Description
Provides information about origin groups that are associated with the distribution.
Members
- Items
-
- Type: Array of AwsCloudFrontDistributionOriginGroup structures
The list of origin groups.
AwsCloudFrontDistributionOriginItem
Description
A complex type that describes the S3 bucket, HTTP server (for example, a web server), AWS Elemental MediaStore, or other server from which CloudFront gets your files.
Members
- DomainName
-
- Type: string
Amazon S3 origins: The DNS name of the S3 bucket from which you want CloudFront to get objects for this origin.
- Id
-
- Type: string
A unique identifier for the origin or origin group.
- OriginPath
-
- Type: string
An optional element that causes CloudFront to request your content from a directory in your Amazon S3 bucket or your custom origin.
- S3OriginConfig
-
- Type: AwsCloudFrontDistributionOriginS3OriginConfig structure
An origin that is an S3 bucket that is not configured with static website hosting.
AwsCloudFrontDistributionOriginS3OriginConfig
Description
Information about an origin that is an S3 bucket that is not configured with static website hosting.
Members
AwsCloudFrontDistributionOrigins
Description
A complex type that contains information about origins and origin groups for this distribution.
Members
- Items
-
- Type: Array of AwsCloudFrontDistributionOriginItem structures
A complex type that contains origins or origin groups for this distribution.
AwsCloudTrailTrailDetails
Description
Provides details about a CloudTrail trail.
Members
- CloudWatchLogsLogGroupArn
-
- Type: string
The ARN of the log group that CloudTrail logs are delivered to.
- CloudWatchLogsRoleArn
-
- Type: string
The ARN of the role that the CloudWatch Events endpoint assumes when it writes to the log group.
- HasCustomEventSelectors
-
- Type: boolean
Indicates whether the trail has custom event selectors.
- HomeRegion
-
- Type: string
The Region where the trail was created.
- IncludeGlobalServiceEvents
-
- Type: boolean
Indicates whether the trail publishes events from global services such as IAM to the log files.
- IsMultiRegionTrail
-
- Type: boolean
Indicates whether the trail applies only to the current Region or to all Regions.
- IsOrganizationTrail
-
- Type: boolean
Whether the trail is created for all accounts in an organization in Organizations, or only for the current Amazon Web Services account.
- KmsKeyId
-
- Type: string
The KMS key ID to use to encrypt the logs.
- LogFileValidationEnabled
-
- Type: boolean
Indicates whether CloudTrail log file validation is enabled.
- Name
-
- Type: string
The name of the trail.
- S3BucketName
-
- Type: string
The name of the S3 bucket where the log files are published.
- S3KeyPrefix
-
- Type: string
The S3 key prefix. The key prefix is added after the name of the S3 bucket where the log files are published.
- SnsTopicArn
-
- Type: string
The ARN of the SNS topic that is used for notifications of log file delivery.
- SnsTopicName
-
- Type: string
The name of the SNS topic that is used for notifications of log file delivery.
- TrailArn
-
- Type: string
The ARN of the trail.
AwsCodeBuildProjectDetails
Description
Information about an CodeBuild project.
Members
- EncryptionKey
-
- Type: string
The KMS customer master key (CMK) used to encrypt the build output artifacts.
You can specify either the ARN of the CMK or, if available, the CMK alias (using the format alias/alias-name).
- Environment
-
- Type: AwsCodeBuildProjectEnvironment structure
Information about the build environment for this build project.
- Name
-
- Type: string
The name of the build project.
- ServiceRole
-
- Type: string
The ARN of the IAM role that enables CodeBuild to interact with dependent Amazon Web Services services on behalf of the Amazon Web Services account.
- Source
-
- Type: AwsCodeBuildProjectSource structure
Information about the build input source code for this build project.
- VpcConfig
-
- Type: AwsCodeBuildProjectVpcConfig structure
Information about the VPC configuration that CodeBuild accesses.
AwsCodeBuildProjectEnvironment
Description
Information about the build environment for this build project.
Members
- Certificate
-
- Type: string
The certificate to use with this build project.
- ImagePullCredentialsType
-
- Type: string
The type of credentials CodeBuild uses to pull images in your build.
Valid values:
-
CODEBUILDspecifies that CodeBuild uses its own credentials. This requires that you modify your ECR repository policy to trust the CodeBuild service principal. -
SERVICE_ROLEspecifies that CodeBuild uses your build project's service role.
When you use a cross-account or private registry image, you must use
SERVICE_ROLEcredentials. When you use an CodeBuild curated image, you must useCODEBUILDcredentials. - RegistryCredential
-
- Type: AwsCodeBuildProjectEnvironmentRegistryCredential structure
The credentials for access to a private registry.
- Type
-
- Type: string
The type of build environment to use for related builds.
The environment type
ARM_CONTAINERis available only in Regions US East (N. Virginia), US East (Ohio), US West (Oregon), Europe (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Sydney), and Europe (Frankfurt).The environment type
LINUX_CONTAINERwith compute type build.general1.2xlarge is available only in Regions US East (N. Virginia), US East (N. Virginia), US West (Oregon), Canada (Central), Europe (Ireland), Europe (London), Europe (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Seoul), Asia Pacific (Singapore), Asia Pacific (Sydney), China (Beijing), and China (Ningxia).The environment type
LINUX_GPU_CONTAINERis available only in Regions US East (N. Virginia), US East (N. Virginia), US West (Oregon), Canada (Central), Europe (Ireland), Europe (London), Europe (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Seoul), Asia Pacific (Singapore), Asia Pacific (Sydney), China (Beijing), and China (Ningxia).Valid values:
WINDOWS_CONTAINER|LINUX_CONTAINER|LINUX_GPU_CONTAINER|ARM_CONTAINER
AwsCodeBuildProjectEnvironmentRegistryCredential
Description
The credentials for access to a private registry.
Members
- Credential
-
- Type: string
The ARN or name of credentials created using Secrets Manager.
The credential can use the name of the credentials only if they exist in your current Amazon Web Services Region.
- CredentialProvider
-
- Type: string
The service that created the credentials to access a private Docker registry.
The valid value,
SECRETS_MANAGER, is for Secrets Manager.
AwsCodeBuildProjectSource
Description
Information about the build input source code for this build project.
Members
- GitCloneDepth
-
- Type: int
Information about the Git clone depth for the build project.
- InsecureSsl
-
- Type: boolean
Whether to ignore SSL warnings while connecting to the project source code.
- Location
-
- Type: string
Information about the location of the source code to be built.
Valid values include:
-
For source code settings that are specified in the source action of a pipeline in CodePipeline, location should not be specified. If it is specified, CodePipeline ignores it. This is because CodePipeline uses the settings in a pipeline's source action instead of this value.
-
For source code in an CodeCommit repository, the HTTPS clone URL to the repository that contains the source code and the build spec file (for example,
https://git-codecommit.region-ID.amazonaws.com/v1/repos/repo-name). -
For source code in an S3 input bucket, one of the following.
-
The path to the ZIP file that contains the source code (for example,
bucket-name/path/to/object-name.zip). -
The path to the folder that contains the source code (for example,
bucket-name/path/to/source-code/folder/).
-
-
For source code in a GitHub repository, the HTTPS clone URL to the repository that contains the source and the build spec file.
-
For source code in a Bitbucket repository, the HTTPS clone URL to the repository that contains the source and the build spec file.
- Type
-
- Type: string
The type of repository that contains the source code to be built. Valid values are:
-
BITBUCKET- The source code is in a Bitbucket repository. -
CODECOMMIT- The source code is in an CodeCommit repository. -
CODEPIPELINE- The source code settings are specified in the source action of a pipeline in CodePipeline. -
GITHUB- The source code is in a GitHub repository. -
GITHUB_ENTERPRISE- The source code is in a GitHub Enterprise repository. -
NO_SOURCE- The project does not have input source code. -
S3- The source code is in an S3 input bucket.
AwsCodeBuildProjectVpcConfig
Description
Information about the VPC configuration that CodeBuild accesses.
Members
AwsCorsConfiguration
Description
Contains the cross-origin resource sharing (CORS) configuration for the API. CORS is only supported for HTTP APIs.
Members
- AllowCredentials
-
- Type: boolean
Indicates whether the CORS request includes credentials.
- AllowHeaders
-
- Type: Array of strings
The allowed headers for CORS requests.
- AllowMethods
-
- Type: Array of strings
The allowed methods for CORS requests.
- AllowOrigins
-
- Type: Array of strings
The allowed origins for CORS requests.
- ExposeHeaders
-
- Type: Array of strings
The exposed headers for CORS requests.
- MaxAge
-
- Type: int
The number of seconds for which the browser caches preflight request results.
AwsDynamoDbTableAttributeDefinition
Description
Contains a definition of an attribute for the table.
Members
AwsDynamoDbTableBillingModeSummary
Description
Provides information about the billing for read/write capacity on the table.
Members
- BillingMode
-
- Type: string
The method used to charge for read and write throughput and to manage capacity.
- LastUpdateToPayPerRequestDateTime
-
- Type: string
If the billing mode is
PAY_PER_REQUEST, indicates when the billing mode was set to that value.Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z.
AwsDynamoDbTableDetails
Description
Provides details about a DynamoDB table.
Members
- AttributeDefinitions
-
- Type: Array of AwsDynamoDbTableAttributeDefinition structures
A list of attribute definitions for the table.
- BillingModeSummary
-
- Type: AwsDynamoDbTableBillingModeSummary structure
Information about the billing for read/write capacity on the table.
- CreationDateTime
-
- Type: string
Indicates when the table was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - GlobalSecondaryIndexes
-
- Type: Array of AwsDynamoDbTableGlobalSecondaryIndex structures
List of global secondary indexes for the table.
- GlobalTableVersion
-
- Type: string
The version of global tables being used.
- ItemCount
-
- Type: int
The number of items in the table.
- KeySchema
-
- Type: Array of AwsDynamoDbTableKeySchema structures
The primary key structure for the table.
- LatestStreamArn
-
- Type: string
The ARN of the latest stream for the table.
- LatestStreamLabel
-
- Type: string
The label of the latest stream. The label is not a unique identifier.
- LocalSecondaryIndexes
-
- Type: Array of AwsDynamoDbTableLocalSecondaryIndex structures
The list of local secondary indexes for the table.
- ProvisionedThroughput
-
- Type: AwsDynamoDbTableProvisionedThroughput structure
Information about the provisioned throughput for the table.
- Replicas
-
- Type: Array of AwsDynamoDbTableReplica structures
The list of replicas of this table.
- RestoreSummary
-
- Type: AwsDynamoDbTableRestoreSummary structure
Information about the restore for the table.
- SseDescription
-
- Type: AwsDynamoDbTableSseDescription structure
Information about the server-side encryption for the table.
- StreamSpecification
-
- Type: AwsDynamoDbTableStreamSpecification structure
The current DynamoDB Streams configuration for the table.
- TableId
-
- Type: string
The identifier of the table.
- TableName
-
- Type: string
The name of the table.
- TableSizeBytes
-
- Type: long (int|float)
The total size of the table in bytes.
- TableStatus
-
- Type: string
The current status of the table.
AwsDynamoDbTableGlobalSecondaryIndex
Description
Information abut a global secondary index for the table.
Members
- Backfilling
-
- Type: boolean
Whether the index is currently backfilling.
- IndexArn
-
- Type: string
The ARN of the index.
- IndexName
-
- Type: string
The name of the index.
- IndexSizeBytes
-
- Type: long (int|float)
The total size in bytes of the index.
- IndexStatus
-
- Type: string
The current status of the index.
- ItemCount
-
- Type: int
The number of items in the index.
- KeySchema
-
- Type: Array of AwsDynamoDbTableKeySchema structures
The key schema for the index.
- Projection
-
- Type: AwsDynamoDbTableProjection structure
Attributes that are copied from the table into an index.
- ProvisionedThroughput
-
- Type: AwsDynamoDbTableProvisionedThroughput structure
Information about the provisioned throughput settings for the indexes.
AwsDynamoDbTableKeySchema
Description
A component of the key schema for the DynamoDB table, a global secondary index, or a local secondary index.
Members
AwsDynamoDbTableLocalSecondaryIndex
Description
Information about a local secondary index for a DynamoDB table.
Members
- IndexArn
-
- Type: string
The ARN of the index.
- IndexName
-
- Type: string
The name of the index.
- KeySchema
-
- Type: Array of AwsDynamoDbTableKeySchema structures
The complete key schema for the index.
- Projection
-
- Type: AwsDynamoDbTableProjection structure
Attributes that are copied from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
AwsDynamoDbTableProjection
Description
For global and local secondary indexes, identifies the attributes that are copied from the table into the index.
Members
AwsDynamoDbTableProvisionedThroughput
Description
Information about the provisioned throughput for the table or for a global secondary index.
Members
- LastDecreaseDateTime
-
- Type: string
Indicates when the provisioned throughput was last decreased.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - LastIncreaseDateTime
-
- Type: string
Indicates when the provisioned throughput was last increased.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - NumberOfDecreasesToday
-
- Type: int
The number of times during the current UTC calendar day that the provisioned throughput was decreased.
- ReadCapacityUnits
-
- Type: int
The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException. - WriteCapacityUnits
-
- Type: int
The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException.
AwsDynamoDbTableProvisionedThroughputOverride
Description
Replica-specific configuration for the provisioned throughput.
Members
AwsDynamoDbTableReplica
Description
Information about a replica of a DynamoDB table.
Members
- GlobalSecondaryIndexes
-
- Type: Array of AwsDynamoDbTableReplicaGlobalSecondaryIndex structures
List of global secondary indexes for the replica.
- KmsMasterKeyId
-
- Type: string
The identifier of the KMS customer master key (CMK) that will be used for KMS encryption for the replica.
- ProvisionedThroughputOverride
-
- Type: AwsDynamoDbTableProvisionedThroughputOverride structure
Replica-specific configuration for the provisioned throughput.
- RegionName
-
- Type: string
The name of the Region where the replica is located.
- ReplicaStatus
-
- Type: string
The current status of the replica.
- ReplicaStatusDescription
-
- Type: string
Detailed information about the replica status.
AwsDynamoDbTableReplicaGlobalSecondaryIndex
Description
Information about a global secondary index for a DynamoDB table replica.
Members
- IndexName
-
- Type: string
The name of the index.
- ProvisionedThroughputOverride
-
- Type: AwsDynamoDbTableProvisionedThroughputOverride structure
Replica-specific configuration for the provisioned throughput for the index.
AwsDynamoDbTableRestoreSummary
Description
Information about the restore for the table.
Members
- RestoreDateTime
-
- Type: string
Indicates the point in time that the table was restored to.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - RestoreInProgress
-
- Type: boolean
Whether a restore is currently in progress.
- SourceBackupArn
-
- Type: string
The ARN of the source backup from which the table was restored.
- SourceTableArn
-
- Type: string
The ARN of the source table for the backup.
AwsDynamoDbTableSseDescription
Description
Information about the server-side encryption for the table.
Members
- InaccessibleEncryptionDateTime
-
- Type: string
If the key is inaccessible, the date and time when DynamoDB detected that the key was inaccessible.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - KmsMasterKeyArn
-
- Type: string
The ARN of the KMS customer master key (CMK) that is used for the KMS encryption.
- SseType
-
- Type: string
The type of server-side encryption.
- Status
-
- Type: string
The status of the server-side encryption.
AwsDynamoDbTableStreamSpecification
Description
The current DynamoDB Streams configuration for the table.
Members
AwsEc2EipDetails
Description
Information about an Elastic IP address.
Members
- AllocationId
-
- Type: string
The identifier that Amazon Web Services assigns to represent the allocation of the Elastic IP address for use with Amazon VPC.
- AssociationId
-
- Type: string
The identifier that represents the association of the Elastic IP address with an EC2 instance.
- Domain
-
- Type: string
The domain in which to allocate the address.
If the address is for use with EC2 instances in a VPC, then
Domainisvpc. Otherwise,Domainisstandard. - InstanceId
-
- Type: string
The identifier of the EC2 instance.
- NetworkBorderGroup
-
- Type: string
The name of the location from which the Elastic IP address is advertised.
- NetworkInterfaceId
-
- Type: string
The identifier of the network interface.
- NetworkInterfaceOwnerId
-
- Type: string
The Amazon Web Services account ID of the owner of the network interface.
- PrivateIpAddress
-
- Type: string
The private IP address that is associated with the Elastic IP address.
- PublicIp
-
- Type: string
A public IP address that is associated with the EC2 instance.
- PublicIpv4Pool
-
- Type: string
The identifier of an IP address pool. This parameter allows Amazon EC2 to select an IP address from the address pool.
AwsEc2InstanceDetails
Description
The details of an EC2 instance.
Members
- IamInstanceProfileArn
-
- Type: string
The IAM profile ARN of the instance.
- ImageId
-
- Type: string
The Amazon Machine Image (AMI) ID of the instance.
- IpV4Addresses
-
- Type: Array of strings
The IPv4 addresses associated with the instance.
- IpV6Addresses
-
- Type: Array of strings
The IPv6 addresses associated with the instance.
- KeyName
-
- Type: string
The key name associated with the instance.
- LaunchedAt
-
- Type: string
Indicates when the instance was launched.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - NetworkInterfaces
-
- Type: Array of AwsEc2InstanceNetworkInterfacesDetails structures
The identifiers of the network interfaces for the EC2 instance. The details for each network interface are in a corresponding
AwsEc2NetworkInterfacesDetailsobject. - SubnetId
-
- Type: string
The identifier of the subnet that the instance was launched in.
- Type
-
- Type: string
The instance type of the instance.
- VpcId
-
- Type: string
The identifier of the VPC that the instance was launched in.
AwsEc2InstanceNetworkInterfacesDetails
Description
Identifies a network interface for the EC2 instance.
Members
AwsEc2NetworkAclAssociation
Description
An association between the network ACL and a subnet.
Members
AwsEc2NetworkAclDetails
Description
Contains details about an EC2 network access control list (ACL).
Members
- Associations
-
- Type: Array of AwsEc2NetworkAclAssociation structures
Associations between the network ACL and subnets.
- Entries
-
- Type: Array of AwsEc2NetworkAclEntry structures
The set of rules in the network ACL.
- IsDefault
-
- Type: boolean
Whether this is the default network ACL for the VPC.
- NetworkAclId
-
- Type: string
The identifier of the network ACL.
- OwnerId
-
- Type: string
The identifier of the Amazon Web Services account that owns the network ACL.
- VpcId
-
- Type: string
The identifier of the VPC for the network ACL.
AwsEc2NetworkAclEntry
Description
A rule for the network ACL. Each rule allows or denies access based on the IP address, traffic direction, port, and protocol.
Members
- CidrBlock
-
- Type: string
The IPV4 network range for which to deny or allow access.
- Egress
-
- Type: boolean
Whether the rule is an egress rule. An egress rule is a rule that applies to traffic that leaves the subnet.
- IcmpTypeCode
-
- Type: IcmpTypeCode structure
The Internet Control Message Protocol (ICMP) type and code for which to deny or allow access.
- Ipv6CidrBlock
-
- Type: string
The IPV6 network range for which to deny or allow access.
- PortRange
-
- Type: PortRangeFromTo structure
For TCP or UDP protocols, the range of ports that the rule applies to.
- Protocol
-
- Type: string
The protocol that the rule applies to. To deny or allow access to all protocols, use the value -1.
- RuleAction
-
- Type: string
Whether the rule is used to allow access or deny access.
- RuleNumber
-
- Type: int
The rule number. The rules are processed in order by their number.
AwsEc2NetworkInterfaceAttachment
Description
Information about the network interface attachment.
Members
- AttachTime
-
- Type: string
Indicates when the attachment initiated.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - AttachmentId
-
- Type: string
The identifier of the network interface attachment
- DeleteOnTermination
-
- Type: boolean
Indicates whether the network interface is deleted when the instance is terminated.
- DeviceIndex
-
- Type: int
The device index of the network interface attachment on the instance.
- InstanceId
-
- Type: string
The ID of the instance.
- InstanceOwnerId
-
- Type: string
The Amazon Web Services account ID of the owner of the instance.
- Status
-
- Type: string
The attachment state.
Valid values:
attaching|attached|detaching|detached
AwsEc2NetworkInterfaceDetails
Description
Details about the network interface
Members
- Attachment
-
- Type: AwsEc2NetworkInterfaceAttachment structure
The network interface attachment.
- IpV6Addresses
-
- Type: Array of AwsEc2NetworkInterfaceIpV6AddressDetail structures
The IPv6 addresses associated with the network interface.
- NetworkInterfaceId
-
- Type: string
The ID of the network interface.
- PrivateIpAddresses
-
- Type: Array of AwsEc2NetworkInterfacePrivateIpAddressDetail structures
The private IPv4 addresses associated with the network interface.
- PublicDnsName
-
- Type: string
The public DNS name of the network interface.
- PublicIp
-
- Type: string
The address of the Elastic IP address bound to the network interface.
- SecurityGroups
-
- Type: Array of AwsEc2NetworkInterfaceSecurityGroup structures
Security groups for the network interface.
- SourceDestCheck
-
- Type: boolean
Indicates whether traffic to or from the instance is validated.
AwsEc2NetworkInterfaceIpV6AddressDetail
Description
Provides information about an IPV6 address that is associated with the network interface.
Members
AwsEc2NetworkInterfacePrivateIpAddressDetail
Description
Provides information about a private IPv4 address that is with the network interface.
Members
AwsEc2NetworkInterfaceSecurityGroup
Description
A security group associated with the network interface.
Members
AwsEc2SecurityGroupDetails
Description
Details about an EC2 security group.
Members
- GroupId
-
- Type: string
The ID of the security group.
- GroupName
-
- Type: string
The name of the security group.
- IpPermissions
-
- Type: Array of AwsEc2SecurityGroupIpPermission structures
The inbound rules associated with the security group.
- IpPermissionsEgress
-
- Type: Array of AwsEc2SecurityGroupIpPermission structures
[VPC only] The outbound rules associated with the security group.
- OwnerId
-
- Type: string
The Amazon Web Services account ID of the owner of the security group.
- VpcId
-
- Type: string
[VPC only] The ID of the VPC for the security group.
AwsEc2SecurityGroupIpPermission
Description
An IP permission for an EC2 security group.
Members
- FromPort
-
- Type: int
The start of the port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type number.
A value of -1 indicates all ICMP/ICMPv6 types. If you specify all ICMP/ICMPv6 types, you must specify all codes.
- IpProtocol
-
- Type: string
The IP protocol name (
tcp,udp,icmp,icmpv6) or number.[VPC only] Use
-1to specify all protocols.When authorizing security group rules, specifying -1 or a protocol number other than
tcp,udp,icmp, oricmpv6allows traffic on all ports, regardless of any port range you specify.For
tcp,udp, andicmp, you must specify a port range.For
icmpv6, the port range is optional. If you omit the port range, traffic for all types and codes is allowed. - IpRanges
-
- Type: Array of AwsEc2SecurityGroupIpRange structures
The IPv4 ranges.
- Ipv6Ranges
-
- Type: Array of AwsEc2SecurityGroupIpv6Range structures
The IPv6 ranges.
- PrefixListIds
-
- Type: Array of AwsEc2SecurityGroupPrefixListId structures
[VPC only] The prefix list IDs for an Amazon Web Services service. With outbound rules, this is the Amazon Web Services service to access through a VPC endpoint from instances associated with the security group.
- ToPort
-
- Type: int
The end of the port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
A value of -1 indicates all ICMP/ICMPv6 codes. If you specify all ICMP/ICMPv6 types, you must specify all codes.
- UserIdGroupPairs
-
- Type: Array of AwsEc2SecurityGroupUserIdGroupPair structures
The security group and Amazon Web Services account ID pairs.
AwsEc2SecurityGroupIpRange
Description
A range of IPv4 addresses.
Members
AwsEc2SecurityGroupIpv6Range
Description
A range of IPv6 addresses.
Members
AwsEc2SecurityGroupPrefixListId
AwsEc2SecurityGroupUserIdGroupPair
Description
A relationship between a security group and a user.
Members
- GroupId
-
- Type: string
The ID of the security group.
- GroupName
-
- Type: string
The name of the security group.
- PeeringStatus
-
- Type: string
The status of a VPC peering connection, if applicable.
- UserId
-
- Type: string
The ID of an Amazon Web Services account.
For a referenced security group in another VPC, the account ID of the referenced security group is returned in the response. If the referenced security group is deleted, this value is not returned.
[EC2-Classic] Required when adding or removing rules that reference a security group in another VPC.
- VpcId
-
- Type: string
The ID of the VPC for the referenced security group, if applicable.
- VpcPeeringConnectionId
-
- Type: string
The ID of the VPC peering connection, if applicable.
AwsEc2SubnetDetails
Description
Contains information about a subnet in Amazon EC2.
Members
- AssignIpv6AddressOnCreation
-
- Type: boolean
Whether to assign an IPV6 address to a network interface that is created in this subnet.
- AvailabilityZone
-
- Type: string
The Availability Zone for the subnet.
- AvailabilityZoneId
-
- Type: string
The identifier of the Availability Zone for the subnet.
- AvailableIpAddressCount
-
- Type: int
The number of available IPV4 addresses in the subnet. Does not include addresses for stopped instances.
- CidrBlock
-
- Type: string
The IPV4 CIDR block that is assigned to the subnet.
- DefaultForAz
-
- Type: boolean
Whether this subnet is the default subnet for the Availability Zone.
- Ipv6CidrBlockAssociationSet
-
- Type: Array of Ipv6CidrBlockAssociation structures
The IPV6 CIDR blocks that are associated with the subnet.
- MapPublicIpOnLaunch
-
- Type: boolean
Whether instances in this subnet receive a public IP address.
- OwnerId
-
- Type: string
The identifier of the Amazon Web Services account that owns the subnet.
- State
-
- Type: string
The current state of the subnet.
- SubnetArn
-
- Type: string
The ARN of the subnet.
- SubnetId
-
- Type: string
The identifier of the subnet.
- VpcId
-
- Type: string
The identifier of the VPC that contains the subnet.
AwsEc2VolumeAttachment
Description
An attachment to an Amazon EC2 volume.
Members
AwsEc2VolumeDetails
Description
Details about an EC2 volume.
Members
- Attachments
-
- Type: Array of AwsEc2VolumeAttachment structures
The volume attachments.
- CreateTime
-
- Type: string
Indicates when the volume was created.
Uses the
date-timeformat specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example,2020-03-22T13:22:13.933Z. - Encrypted
-
- Type: boolean
Whether the volume is encrypted.
- KmsKeyId
-
- Type: string
The ARN of the KMS customer master key (CMK) that was used to protect the volume encryption key for the volume.
- Size
-
- Type: int
The size of the volume, in GiBs.
- SnapshotId
-
- Type: string
The snapshot from which the volume was created.
- Status
-
- Type: string
The volume state.
AwsEc2VpcDetails
Description
Details about an EC2 VPC.
Members
- CidrBlockAssociationSet
-
- Type: Array of CidrBlockAssociation structures
Information about the IPv4 CIDR blocks associated with the VPC.
- DhcpOptionsId
-
- Type: string
The identifier of the set of Dynamic Host Configuration Protocol (DHCP) options that are associated with the VPC. If the default options are associated with the VPC, then this is default.
- Ipv6CidrBlockAssociationSet
-
- Type: Array of Ipv6CidrBlockAssociation structures
Information about the IPv6 CIDR blocks associated with the VPC.
- State
-
- Type: string
The current state of the VPC.
AwsEcsClusterClusterSettingsDetails
Description
Indicates whether to enable CloudWatch Container Insights for the ECS cluster.
Members
AwsEcsClusterConfigurationDetails
Description
The run command configuration for the cluster.
Members
- ExecuteCommandConfiguration
-
- Type: AwsEcsClusterConfigurationExecuteCommandConfigurationDetails structure
Contains the run command configuration for the cluster.
AwsEcsClusterConfigurationExecuteCommandConfigurationDetails
Description
Contains the run command configuration for the cluster.
Members
- KmsKeyId
-
- Type: string
The identifier of the KMS key that is used to encrypt the data between the local client and the container.
- LogConfiguration
-
The log configuration for the results of the run command actions. Required if
LoggingisNONE. - Logging
-
- Type: string
The log setting to use for redirecting logs for run command results.
AwsEcsClusterConfigurationExecuteCommandConfigurationLogConfigurationDetails
Description
The log configuration for the results of the run command actions.
Members
- CloudWatchEncryptionEnabled
-
- Type: boolean
Whether to enable encryption on the CloudWatch logs.
- CloudWatchLogGroupName
-
- Type: string
The name of the CloudWatch log group to send the logs to.
- S3BucketName
-
- Type: string
The name of the S3 bucket to send logs to.
- S3EncryptionEnabled
-
- Type: boolean
Whether to encrypt the logs that are sent to the S3 bucket.
- S3KeyPrefix
-
- Type: string
Identifies the folder in the S3 bucket to send the logs to.
AwsEcsClusterDefaultCapacityProviderStrategyDetails
Description
The default capacity provider strategy for the cluster. The default capacity provider strategy is used when services or tasks are run without a specified launch type or capacity provider strategy.
Members
AwsEcsClusterDetails
Description
provides details about an ECS cluster.
Members
- CapacityProviders
-
- Type: Array of strings
The short name of one or more capacity providers to associate with the cluster.
- ClusterSettings
-
- Type: Array of AwsEcsClusterClusterSettingsDetails structures
The setting to use to create the cluster. Specifically used to configure whether to enable CloudWatch Container Insights for the cluster.
- Configuration
-
- Type: AwsEcsClusterConfigurationDetails structure
The run command configuration for the cluster.
- DefaultCapacityProviderStrategy
-
- Type: Array of AwsEcsClusterDefaultCapacityProviderStrategyDetails structures
The default capacity provider strategy for the cluster. The default capacity provider strategy is used when services or tasks are run without a specified launch type or capacity provider strategy.
AwsEcsServiceCapacityProviderStrategyDetails
Description
Strategy item for the capacity provider strategy that the service uses.
Members
- Base
-
- Type: int
The minimum number of tasks to run on the capacity provider. Only one strategy item can specify a value for
Base.The value must be between 0 and 100000.
- CapacityProvider
-
- Type: string
The short name of the capacity provider.
- Weight
-
- Type: int
The relative percentage of the total number of tasks that should use the capacity provider.
If no weight is specified, the default value is 0. At least one capacity provider must have a weight greater than 0.
The value can be between 0 and 1000.
AwsEcsServiceDeploymentConfigurationDeploymentCircuitBreakerDetails
Description
Determines whether a service deployment fails if a service cannot reach a steady state.
Members
- Enable
-
- Type: boolean
Whether to enable the deployment circuit breaker logic for the service.
- Rollback
-
- Type: boolean
Whether to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.
AwsEcsServiceDeploymentConfigurationDetails
Description
Optional deployment parameters for the service.
Members
- DeploymentCircuitBreaker
-
Determines whether a service deployment fails if a service cannot reach a steady state.
- MaximumPercent
-
- Type: int
For a service that uses the rolling update (
ECS) deployment type, the maximum number of tasks in a service that are allowed in theRUNNINGorPENDINGstate during a deployment, and for tasks that use the EC2 launch type, when any container instances are in theDRAININGstate. Provided as a percentage of the desired number of tasks. The default value is 200%.For a service that uses the blue/green (
CODE_DEPLOY) orEXTERNALdeployment types, and tasks that use the EC2 launch type, the maximum number of tasks in the service that remain in theRUNNINGstate while the container instances are in theDRAININGstate.For the Fargate launch type, the maximum percent value is not used.
- MinimumHealthyPercent
-
- Type: int
For a service that uses the rolling update (
ECS) deployment type, the minimum number of tasks in a service that must remain in theRUNNINGstate during a deployment, and while any container instances are in theDRAININGstate if the service contains tasks using the EC2 launch type. Expressed as a percentage of the desired number of tasks. The default value is 100%.For a service that uses the blue/green (
CODE_DEPLOY) orEXTERNALdeployment types and tasks that use the EC2 launch type, the minimum number of the tasks in the service that remain in theRUNNINGstate while the container instances are in theDRAININGstate.For the Fargate launch type, the minimum healthy percent value is not used.
AwsEcsServiceDeploymentControllerDetails
Description
Information about the deployment controller type that the service uses.
Members
- Type
-
- Type: string
The rolling update (
ECS) deployment type replaces the current running version of the container with the latest version.The blue/green (
CODE_DEPLOY) deployment type uses the blue/green deployment model that is powered by CodeDeploy. This deployment model a new deployment of a service can be verified before production traffic is sent to it.The external (
EXTERNAL) deployment type allows the use of any third-party deployment controller for full control over the deployment process for an Amazon ECS service.Valid values:
ECS|CODE_DEPLOY|EXTERNAL
AwsEcsServiceDetails
Description
Provides details about a service within an ECS cluster.
Members
- CapacityProviderStrategy
-
- Type: Array of AwsEcsServiceCapacityProviderStrategyDetails structures
The capacity provider strategy that the service uses.
- Cluster
-
- Type: string
The ARN of the cluster that hosts the service.
- DeploymentConfiguration
-
- Type: AwsEcsServiceDeploymentConfigurationDetails structure
Deployment parameters for the service. Includes the number of tasks that run and the order in which to start and stop tasks.
- DeploymentController
-
- Type: AwsEcsServiceDeploymentControllerDetails structure
Contains the deployment controller type that the service uses.
- DesiredCount
-
- Type: int
The number of instantiations of the task definition to run on the service.
- EnableEcsManagedTags
-
- Type: boolean
Whether to enable Amazon ECS managed tags for the tasks in the service.
- EnableExecuteCommand
-
- Type: boolean
Whether the execute command functionality is enabled for the service.
- HealthCheckGracePeriodSeconds
-
- Type: int
After a task starts, the amount of time in seconds that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks.
- LaunchType
-
- Type: string
The launch type that the service uses.
Valid values:
EC2|FARGATE|EXTERNAL - LoadBalancers
-
- Type: Array of AwsEcsServiceLoadBalancersDetails structures
Information about the load balancers that the service uses.
- Name
-
- Type: string
The name of the service.
- NetworkConfiguration
-
- Type: AwsEcsServiceNetworkConfigurationDetails structure
For tasks that use the
awsvpcnetworking mode, the VPC subnet and security group configuration. - PlacementConstraints
-
- Type: Array of AwsEcsServicePlacementConstraintsDetails structures
The placement constraints for the tasks in the service.
- PlacementStrategies
-
- Type: Array of AwsEcsServicePlacementStrategiesDetails structures
Information about how tasks for the service are placed.
- PlatformVersion
-
- Type: string
The platform version on which to run the service. Only specified for tasks that are hosted on Fargate. If a platform version is not specified, the
LATESTplatform version is used by default. - PropagateTags
-
- Type: string
Indicates whether to propagate the tags from the task definition to the task or from the service to the task. If no value is provided, then tags are not propagated.
Valid values:
TASK_DEFINITION|SERVICE - Role
-
- Type: string
The ARN of the IAM role that is associated with the service. The role allows the Amazon ECS container agent to register container instances with an Elastic Load Balancing load balancer.
- SchedulingStrategy
-
- Type: string
The scheduling strategy to use for the service.
The
REPLICAscheduling strategy places and maintains the desired number of tasks across the cluster. By default, the service scheduler spreads tasks across Availability Zones. Task placement strategies and constraints are used to customize task placement decisions.The
DAEMONscheduling strategy deploys exactly one task on each active container instance that meets all of the task placement constraints that are specified in the cluster. The service scheduler also evaluates the task placement constraints for running tasks and stops tasks that do not meet the placement constraints.Valid values:
REPLICA|DAEMON - ServiceArn
-
- Type: string
The ARN of the service.