- HTTP request
 - Path parameters
 - Request body
 - Response body
 - Authorization scopes
 - IAM Permissions
 - Try it!
 
Full name: projects.locations.instances.marketplaceIntegrations.install
Installs a MarketplaceIntegration.
HTTP request
Path parameters
| Parameters | |
|---|---|
parent | 
                
                   
 Required. The instance to install MarketplaceIntegrations for. Format: projects/{project}/locations/{location}/instances/{instance} Override integration's ontology if integration is already installed. Can be optional, if not provided set to false by default.  | 
              
Request body
The request body contains data with the following structure:
| JSON representation | 
|---|
{ "overrideMapping": boolean, "staging": boolean, "version": string, "restoreIntegrationSnapshot": boolean }  | 
                
| Fields | |
|---|---|
overrideMapping | 
                  
                     
 Optional. Determines if the integration should override the ontology if already installed, if not provided, set to false by default.  | 
                
staging | 
                  
                     
 Optional. Determines if the integration should be installed as staging or production, if not provided, installed as production.  | 
                
version | 
                  
                     
 Optional. Determines which version of the integration should be installed.  | 
                
restoreIntegrationSnapshot | 
                  
                     
 Optional. Determines if the integration should be installed from existing integration snapshot.  | 
                
Response body
Response message for marketplaceIntegrations.install.
If successful, the response body contains data with the following structure:
| JSON representation | 
|---|
{ "identifier": string, "version": string }  | 
                  
| Fields | |
|---|---|
identifier | 
                    
                       
 Required. The installed integration.  | 
                  
version | 
                    
                       
 Output only. The installed integration version.  | 
                  
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the parent resource:
chronicle.marketplaceIntegrations.install
For more information, see the IAM documentation.