openapi: 3.0.0
info:
version: '2020-06-08'
x-release: v4
title: Inspector2 Accountpermissions Ec2deepinspectionconfiguration API
description: Amazon Inspector is a vulnerability discovery service that automates continuous scanning for security vulnerabilities within your Amazon EC2 and Amazon ECR environments.
x-logo:
url: https://twitter.com/awscloud/profile_image?size=original
backgroundColor: '#FFFFFF'
termsOfService: https://aws.amazon.com/service-terms/
contact:
name: Mike Ralphson
email: mike.ralphson@gmail.com
url: https://github.com/mermade/aws2openapi
x-twitter: PermittedSoc
license:
name: Apache 2.0 License
url: http://www.apache.org/licenses/
x-providerName: amazonaws.com
x-serviceName: inspector2
x-aws-signingName: inspector2
x-origin:
- contentType: application/json
url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/inspector2-2020-06-08.normal.json
converter:
url: https://github.com/mermade/aws2openapi
version: 1.0.0
x-apisguru-driver: external
x-apiClientRegistration:
url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
x-apisguru-categories:
- cloud
x-preferred: true
servers:
- url: http://inspector2.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Inspector2 multi-region endpoint
- url: https://inspector2.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Inspector2 multi-region endpoint
- url: http://inspector2.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Inspector2 endpoint for China (Beijing) and China (Ningxia)
- url: https://inspector2.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Inspector2 endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: Ec2deepinspectionconfiguration
paths:
/ec2deepinspectionconfiguration/get:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: GetEc2DeepInspectionConfiguration
description: 'Retrieves the activation status of Amazon Inspector deep inspection and custom paths associated with your account. '
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetEc2DeepInspectionConfigurationResponse'
'480':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'481':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'482':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'483':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
parameters: []
summary: Amazon Inspector Get Ec2 Deep Inspection Configuration
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Ec2deepinspectionconfiguration
/ec2deepinspectionconfiguration/update:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: UpdateEc2DeepInspectionConfiguration
description: 'Activates, deactivates Amazon Inspector deep inspection, or updates custom paths for your account. '
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateEc2DeepInspectionConfigurationResponse'
'480':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
'481':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'482':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'483':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
activateDeepInspection:
description: Specify TRUE to activate Amazon Inspector deep inspection in your account, or FALSE to deactivate. Member accounts in an organization cannot deactivate deep inspection, instead the delegated administrator for the organization can deactivate a member account using BatchUpdateMemberEc2DeepInspectionStatus.
type: boolean
packagePaths:
description: The Amazon Inspector deep inspection custom paths you are adding for your account.
type: array
items:
$ref: '#/components/schemas/Path'
minItems: 0
maxItems: 5
summary: Amazon Inspector Update Ec2 Deep Inspection Configuration
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Ec2deepinspectionconfiguration
/ec2deepinspectionconfiguration/org/update:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: UpdateOrgEc2DeepInspectionConfiguration
description: Updates the Amazon Inspector deep inspection custom paths for your organization. You must be an Amazon Inspector delegated administrator to use this API.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateOrgEc2DeepInspectionConfigurationResponse'
'480':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
'481':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'482':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'483':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- orgPackagePaths
properties:
orgPackagePaths:
description: The Amazon Inspector deep inspection custom paths you are adding for your organization.
type: array
items:
$ref: '#/components/schemas/Path'
minItems: 0
maxItems: 5
summary: Amazon Inspector Update Org Ec2 Deep Inspection Configuration
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Ec2deepinspectionconfiguration
components:
parameters:
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
schemas:
Path:
type: string
pattern: ^(?:/(?:\.[-\w]+|[-\w]+(?:\.[-\w]+)?))+/?$
minLength: 1
maxLength: 512
PathList:
type: array
items:
$ref: '#/components/schemas/Path'
minItems: 0
maxItems: 5
NonEmptyString:
type: string
minLength: 1
Ec2DeepInspectionStatus:
type: string
enum:
- ACTIVATED
- DEACTIVATED
- PENDING
- FAILED
UpdateOrgEc2DeepInspectionConfigurationResponse:
type: object
properties: {}
GetEc2DeepInspectionConfigurationResponse:
type: object
properties:
errorMessage:
allOf:
- $ref: '#/components/schemas/NonEmptyString'
- description: An error message explaining why Amazon Inspector deep inspection configurations could not be retrieved for your account.
orgPackagePaths:
allOf:
- $ref: '#/components/schemas/PathList'
- description: The Amazon Inspector deep inspection custom paths for your organization.
packagePaths:
allOf:
- $ref: '#/components/schemas/PathList'
- description: The Amazon Inspector deep inspection custom paths for your account.
status:
allOf:
- $ref: '#/components/schemas/Ec2DeepInspectionStatus'
- description: The activation status of Amazon Inspector deep inspection in your account.
UpdateEc2DeepInspectionConfigurationResponse:
type: object
properties:
errorMessage:
allOf:
- $ref: '#/components/schemas/NonEmptyString'
- description: An error message explaining why new Amazon Inspector deep inspection custom paths could not be added.
orgPackagePaths:
allOf:
- $ref: '#/components/schemas/PathList'
- description: The current Amazon Inspector deep inspection custom paths for the organization.
packagePaths:
allOf:
- $ref: '#/components/schemas/PathList'
- description: The current Amazon Inspector deep inspection custom paths for your account.
status:
allOf:
- $ref: '#/components/schemas/Ec2DeepInspectionStatus'
- description: The status of Amazon Inspector deep inspection in your account.
AccessDeniedException: {}
InternalServerException: {}
ThrottlingException: {}
ResourceNotFoundException: {}
ValidationException: {}
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/inspector2/
x-hasEquivalentPaths: true