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