OpenSearchService / Client / dissociate_package

dissociate_package#

OpenSearchService.Client.dissociate_package(**kwargs)#

Removes a package from the specified Amazon OpenSearch Service domain. The package can’t be in use with any OpenSearch index for the dissociation to succeed. The package is still available in OpenSearch Service for association later. For more information, see Custom packages for Amazon OpenSearch Service.

Request Syntax

response = client.dissociate_package(
    PackageID='string',
    DomainName='string'
)

Parameters:

PackageID (string) –
[REQUIRED]

Internal ID of the package to dissociate from the domain. Use ListPackagesForDomain to find this value.
DomainName (string) –
[REQUIRED]

Name of the domain to dissociate the package from.

Return type:

dict

Returns:

Response Syntax

{
    'DomainPackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN'|'PACKAGE-LICENSE'|'PACKAGE-CONFIG',
        'LastUpdated': datetime(2015, 1, 1),
        'DomainName': 'string',
        'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
        'PackageVersion': 'string',
        'PrerequisitePackageIDList': [
            'string',
        ],
        'ReferencePath': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        },
        'AssociationConfiguration': {
            'KeyStoreAccessOption': {
                'KeyAccessRoleArn': 'string',
                'KeyStoreAccessEnabled': True|False
            }
        }
    }
}

Response Structure

(dict) –

Container for the response returned by an DissociatePackage operation.
- DomainPackageDetails (dict) –
  
  Information about a package that has been dissociated from the domain.
  - PackageID (string) –
    
    Internal ID of the package.
  - PackageName (string) –
    
    User-specified name of the package.
  - PackageType (string) –
    
    The type of package.
  - LastUpdated (datetime) –
    
    Timestamp of the most recent update to the package association status.
  - DomainName (string) –
    
    Name of the domain that the package is associated with.
  - DomainPackageStatus (string) –
    
    State of the association.
  - PackageVersion (string) –
    
    The current version of the package.
  - PrerequisitePackageIDList (list) –
    
    A list of package IDs that must be associated with the domain before or with the package can be associated.
    - (string) –
  - ReferencePath (string) –
    
    The relative path of the package on the OpenSearch Service cluster nodes. This is synonym_path when the package is for synonym files.
  - ErrorDetails (dict) –
    
    Additional information if the package is in an error state. Null otherwise.
    - ErrorType (string) –
      
      The type of error that occurred.
    - ErrorMessage (string) –
      
      A message describing the error.
  - AssociationConfiguration (dict) –
    
    The configuration for associating a package with an Amazon OpenSearch Service domain.
    - KeyStoreAccessOption (dict) –
      
      The configuration parameters to enable accessing the key store required by the package.
      - KeyAccessRoleArn (string) –
        
        Role ARN to access the KeyStore Key
      - KeyStoreAccessEnabled (boolean) –
        
        This indicates whether Key Store access is enabled

Exceptions

OpenSearchService.Client.exceptions.BaseException
OpenSearchService.Client.exceptions.InternalException
OpenSearchService.Client.exceptions.ResourceNotFoundException
OpenSearchService.Client.exceptions.AccessDeniedException
OpenSearchService.Client.exceptions.ValidationException
OpenSearchService.Client.exceptions.ConflictException