Amazon OpenSearch Service

2023/10/16 - Amazon OpenSearch Service - 9 updated api methods

Changes  This release allows customers to list and associate optional plugin packages with compatible Amazon OpenSearch Service clusters for enhanced functionality.

AssociatePackage (updated) Link ¶
Changes (response)
{'DomainPackageDetails': {'PackageType': {'ZIP-PLUGIN'}}}

Associates a package with an Amazon OpenSearch Service domain. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.associate_package(
    PackageID='string',
    DomainName='string'
)
type PackageID

string

param PackageID

[REQUIRED]

Internal ID of the package to associate with a domain. Use DescribePackages to find this value.

type DomainName

string

param DomainName

[REQUIRED]

Name of the domain to associate the package with.

rtype

dict

returns

Response Syntax

{
    'DomainPackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
        'LastUpdated': datetime(2015, 1, 1),
        'DomainName': 'string',
        'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
        'PackageVersion': 'string',
        'ReferencePath': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by the AssociatePackage operation.

    • DomainPackageDetails (dict) --

      Information about a package that is associated with a 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.

      • 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.

CreatePackage (updated) Link ¶
Changes (request, response)
Request
{'PackageType': {'ZIP-PLUGIN'}}
Response
{'PackageDetails': {'AvailablePluginProperties': {'ClassName': 'string',
                                                  'Description': 'string',
                                                  'Name': 'string',
                                                  'UncompressedSizeInBytes': 'long',
                                                  'Version': 'string'},
                    'EngineVersion': 'string',
                    'PackageType': {'ZIP-PLUGIN'}}}

Creates a package for use with Amazon OpenSearch Service domains. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.create_package(
    PackageName='string',
    PackageType='TXT-DICTIONARY'|'ZIP-PLUGIN',
    PackageDescription='string',
    PackageSource={
        'S3BucketName': 'string',
        'S3Key': 'string'
    }
)
type PackageName

string

param PackageName

[REQUIRED]

Unique name for the package.

type PackageType

string

param PackageType

[REQUIRED]

The type of package.

type PackageDescription

string

param PackageDescription

Description of the package.

type PackageSource

dict

param PackageSource

[REQUIRED]

The Amazon S3 location from which to import the package.

  • S3BucketName (string) --

    The name of the Amazon S3 bucket containing the package.

  • S3Key (string) --

    Key (file name) of the package.

rtype

dict

returns

Response Syntax

{
    'PackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
        'PackageDescription': 'string',
        'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'AvailablePackageVersion': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        },
        'EngineVersion': 'string',
        'AvailablePluginProperties': {
            'Name': 'string',
            'Description': 'string',
            'Version': 'string',
            'ClassName': 'string',
            'UncompressedSizeInBytes': 123
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by the CreatePackage operation.

    • PackageDetails (dict) --

      Basic information about an OpenSearch Service package.

      • PackageID (string) --

        The unique identifier of the package.

      • PackageName (string) --

        The user-specified name of the package.

      • PackageType (string) --

        The type of package.

      • PackageDescription (string) --

        User-specified description of the package.

      • PackageStatus (string) --

        The current status of the package. The available options are AVAILABLE , COPYING , COPY_FAILED , VALIDATNG , VALIDATION_FAILED , DELETING , and DELETE_FAILED .

      • CreatedAt (datetime) --

        The timestamp when the package was created.

      • LastUpdatedAt (datetime) --

        Date and time when the package was last updated.

      • AvailablePackageVersion (string) --

        The package version.

      • 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.

      • EngineVersion (string) --

        Version of OpenSearch or Elasticsearch, in the format Elasticsearch_X.Y or OpenSearch_X.Y. Defaults to the latest version of OpenSearch.

      • AvailablePluginProperties (dict) --

        If the package is a ZIP-PLUGIN package, additional information about plugin properties.

        • Name (string) --

          The name of the plugin.

        • Description (string) --

          The description of the plugin.

        • Version (string) --

          The version of the plugin.

        • ClassName (string) --

          The name of the class to load.

        • UncompressedSizeInBytes (integer) --

          The uncompressed size of the plugin.

DeletePackage (updated) Link ¶
Changes (response)
{'PackageDetails': {'AvailablePluginProperties': {'ClassName': 'string',
                                                  'Description': 'string',
                                                  'Name': 'string',
                                                  'UncompressedSizeInBytes': 'long',
                                                  'Version': 'string'},
                    'EngineVersion': 'string',
                    'PackageType': {'ZIP-PLUGIN'}}}

Deletes an Amazon OpenSearch Service package. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.delete_package(
    PackageID='string'
)
type PackageID

string

param PackageID

[REQUIRED]

The internal ID of the package you want to delete. Use DescribePackages to find this value.

rtype

dict

returns

Response Syntax

{
    'PackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
        'PackageDescription': 'string',
        'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'AvailablePackageVersion': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        },
        'EngineVersion': 'string',
        'AvailablePluginProperties': {
            'Name': 'string',
            'Description': 'string',
            'Version': 'string',
            'ClassName': 'string',
            'UncompressedSizeInBytes': 123
        }
    }
}

Response Structure

  • (dict) --

    Container for the response parameters to the DeletePackage operation.

    • PackageDetails (dict) --

      Information about the deleted package.

      • PackageID (string) --

        The unique identifier of the package.

      • PackageName (string) --

        The user-specified name of the package.

      • PackageType (string) --

        The type of package.

      • PackageDescription (string) --

        User-specified description of the package.

      • PackageStatus (string) --

        The current status of the package. The available options are AVAILABLE , COPYING , COPY_FAILED , VALIDATNG , VALIDATION_FAILED , DELETING , and DELETE_FAILED .

      • CreatedAt (datetime) --

        The timestamp when the package was created.

      • LastUpdatedAt (datetime) --

        Date and time when the package was last updated.

      • AvailablePackageVersion (string) --

        The package version.

      • 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.

      • EngineVersion (string) --

        Version of OpenSearch or Elasticsearch, in the format Elasticsearch_X.Y or OpenSearch_X.Y. Defaults to the latest version of OpenSearch.

      • AvailablePluginProperties (dict) --

        If the package is a ZIP-PLUGIN package, additional information about plugin properties.

        • Name (string) --

          The name of the plugin.

        • Description (string) --

          The description of the plugin.

        • Version (string) --

          The version of the plugin.

        • ClassName (string) --

          The name of the class to load.

        • UncompressedSizeInBytes (integer) --

          The uncompressed size of the plugin.

DescribePackages (updated) Link ¶
Changes (request, response)
Request
{'Filters': {'Name': {'EngineVersion', 'PackageType'}}}
Response
{'PackageDetailsList': {'AvailablePluginProperties': {'ClassName': 'string',
                                                      'Description': 'string',
                                                      'Name': 'string',
                                                      'UncompressedSizeInBytes': 'long',
                                                      'Version': 'string'},
                        'EngineVersion': 'string',
                        'PackageType': {'ZIP-PLUGIN'}}}

Describes all packages available to OpenSearch Service. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.describe_packages(
    Filters=[
        {
            'Name': 'PackageID'|'PackageName'|'PackageStatus'|'PackageType'|'EngineVersion',
            'Value': [
                'string',
            ]
        },
    ],
    MaxResults=123,
    NextToken='string'
)
type Filters

list

param Filters

Only returns packages that match the DescribePackagesFilterList values.

  • (dict) --

    A filter to apply to the DescribePackage response.

    • Name (string) --

      Any field from PackageDetails .

    • Value (list) --

      A non-empty list of values for the specified filter field.

      • (string) --

type MaxResults

integer

param MaxResults

An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.

type NextToken

string

param NextToken

If your initial DescribePackageFilters operation returns a nextToken , you can include the returned nextToken in subsequent DescribePackageFilters operations, which returns results in the next page.

rtype

dict

returns

Response Syntax

{
    'PackageDetailsList': [
        {
            'PackageID': 'string',
            'PackageName': 'string',
            'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
            'PackageDescription': 'string',
            'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
            'CreatedAt': datetime(2015, 1, 1),
            'LastUpdatedAt': datetime(2015, 1, 1),
            'AvailablePackageVersion': 'string',
            'ErrorDetails': {
                'ErrorType': 'string',
                'ErrorMessage': 'string'
            },
            'EngineVersion': 'string',
            'AvailablePluginProperties': {
                'Name': 'string',
                'Description': 'string',
                'Version': 'string',
                'ClassName': 'string',
                'UncompressedSizeInBytes': 123
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response returned by the DescribePackages operation.

    • PackageDetailsList (list) --

      Basic information about a package.

      • (dict) --

        Basic information about a package.

        • PackageID (string) --

          The unique identifier of the package.

        • PackageName (string) --

          The user-specified name of the package.

        • PackageType (string) --

          The type of package.

        • PackageDescription (string) --

          User-specified description of the package.

        • PackageStatus (string) --

          The current status of the package. The available options are AVAILABLE , COPYING , COPY_FAILED , VALIDATNG , VALIDATION_FAILED , DELETING , and DELETE_FAILED .

        • CreatedAt (datetime) --

          The timestamp when the package was created.

        • LastUpdatedAt (datetime) --

          Date and time when the package was last updated.

        • AvailablePackageVersion (string) --

          The package version.

        • 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.

        • EngineVersion (string) --

          Version of OpenSearch or Elasticsearch, in the format Elasticsearch_X.Y or OpenSearch_X.Y. Defaults to the latest version of OpenSearch.

        • AvailablePluginProperties (dict) --

          If the package is a ZIP-PLUGIN package, additional information about plugin properties.

          • Name (string) --

            The name of the plugin.

          • Description (string) --

            The description of the plugin.

          • Version (string) --

            The version of the plugin.

          • ClassName (string) --

            The name of the class to load.

          • UncompressedSizeInBytes (integer) --

            The uncompressed size of the plugin.

    • NextToken (string) --

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

DissociatePackage (updated) Link ¶
Changes (response)
{'DomainPackageDetails': {'PackageType': {'ZIP-PLUGIN'}}}

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 .

See also: AWS API Documentation

Request Syntax

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

string

param PackageID

[REQUIRED]

Internal ID of the package to dissociate from the domain. Use ListPackagesForDomain to find this value.

type DomainName

string

param DomainName

[REQUIRED]

Name of the domain to dissociate the package from.

rtype

dict

returns

Response Syntax

{
    'DomainPackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
        'LastUpdated': datetime(2015, 1, 1),
        'DomainName': 'string',
        'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
        'PackageVersion': 'string',
        'ReferencePath': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

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.

      • 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.

GetPackageVersionHistory (updated) Link ¶
Changes (response)
{'PackageVersionHistoryList': {'PluginProperties': {'ClassName': 'string',
                                                    'Description': 'string',
                                                    'Name': 'string',
                                                    'UncompressedSizeInBytes': 'long',
                                                    'Version': 'string'}}}

Returns a list of Amazon OpenSearch Service package versions, along with their creation time, commit message, and plugin properties (if the package is a zip plugin package). For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.get_package_version_history(
    PackageID='string',
    MaxResults=123,
    NextToken='string'
)
type PackageID

string

param PackageID

[REQUIRED]

The unique identifier of the package.

type MaxResults

integer

param MaxResults

An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.

type NextToken

string

param NextToken

If your initial GetPackageVersionHistory operation returns a nextToken , you can include the returned nextToken in subsequent GetPackageVersionHistory operations, which returns results in the next page.

rtype

dict

returns

Response Syntax

{
    'PackageID': 'string',
    'PackageVersionHistoryList': [
        {
            'PackageVersion': 'string',
            'CommitMessage': 'string',
            'CreatedAt': datetime(2015, 1, 1),
            'PluginProperties': {
                'Name': 'string',
                'Description': 'string',
                'Version': 'string',
                'ClassName': 'string',
                'UncompressedSizeInBytes': 123
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for response returned by GetPackageVersionHistory operation.

    • PackageID (string) --

      The unique identifier of the package.

    • PackageVersionHistoryList (list) --

      A list of package versions, along with their creation time and commit message.

      • (dict) --

        Details about a package version.

        • PackageVersion (string) --

          The package version.

        • CommitMessage (string) --

          A message associated with the package version when it was uploaded.

        • CreatedAt (datetime) --

          The date and time when the package was created.

        • PluginProperties (dict) --

          Additional information about plugin properties if the package is a ZIP-PLUGIN package.

          • Name (string) --

            The name of the plugin.

          • Description (string) --

            The description of the plugin.

          • Version (string) --

            The version of the plugin.

          • ClassName (string) --

            The name of the class to load.

          • UncompressedSizeInBytes (integer) --

            The uncompressed size of the plugin.

    • NextToken (string) --

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

ListDomainsForPackage (updated) Link ¶
Changes (response)
{'DomainPackageDetailsList': {'PackageType': {'ZIP-PLUGIN'}}}

Lists all Amazon OpenSearch Service domains associated with a given package. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.list_domains_for_package(
    PackageID='string',
    MaxResults=123,
    NextToken='string'
)
type PackageID

string

param PackageID

[REQUIRED]

The unique identifier of the package for which to list associated domains.

type MaxResults

integer

param MaxResults

An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.

type NextToken

string

param NextToken

If your initial ListDomainsForPackage operation returns a nextToken , you can include the returned nextToken in subsequent ListDomainsForPackage operations, which returns results in the next page.

rtype

dict

returns

Response Syntax

{
    'DomainPackageDetailsList': [
        {
            'PackageID': 'string',
            'PackageName': 'string',
            'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
            'LastUpdated': datetime(2015, 1, 1),
            'DomainName': 'string',
            'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
            'PackageVersion': 'string',
            'ReferencePath': 'string',
            'ErrorDetails': {
                'ErrorType': 'string',
                'ErrorMessage': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response parameters to the ListDomainsForPackage operation.

    • DomainPackageDetailsList (list) --

      Information about all domains associated with a package.

      • (dict) --

        Information about a package that is associated with a domain. For more information, see Custom packages for Amazon OpenSearch Service .

        • 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.

        • 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.

    • NextToken (string) --

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

ListPackagesForDomain (updated) Link ¶
Changes (response)
{'DomainPackageDetailsList': {'PackageType': {'ZIP-PLUGIN'}}}

Lists all packages associated with an Amazon OpenSearch Service domain. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.list_packages_for_domain(
    DomainName='string',
    MaxResults=123,
    NextToken='string'
)
type DomainName

string

param DomainName

[REQUIRED]

The name of the domain for which you want to list associated packages.

type MaxResults

integer

param MaxResults

An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.

type NextToken

string

param NextToken

If your initial ListPackagesForDomain operation returns a nextToken , you can include the returned nextToken in subsequent ListPackagesForDomain operations, which returns results in the next page.

rtype

dict

returns

Response Syntax

{
    'DomainPackageDetailsList': [
        {
            'PackageID': 'string',
            'PackageName': 'string',
            'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
            'LastUpdated': datetime(2015, 1, 1),
            'DomainName': 'string',
            'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
            'PackageVersion': 'string',
            'ReferencePath': 'string',
            'ErrorDetails': {
                'ErrorType': 'string',
                'ErrorMessage': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response parameters to the ListPackagesForDomain operation.

    • DomainPackageDetailsList (list) --

      List of all packages associated with a domain.

      • (dict) --

        Information about a package that is associated with a domain. For more information, see Custom packages for Amazon OpenSearch Service .

        • 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.

        • 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.

    • NextToken (string) --

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

UpdatePackage (updated) Link ¶
Changes (response)
{'PackageDetails': {'AvailablePluginProperties': {'ClassName': 'string',
                                                  'Description': 'string',
                                                  'Name': 'string',
                                                  'UncompressedSizeInBytes': 'long',
                                                  'Version': 'string'},
                    'EngineVersion': 'string',
                    'PackageType': {'ZIP-PLUGIN'}}}

Updates a package for use with Amazon OpenSearch Service domains. For more information, see Custom packages for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.update_package(
    PackageID='string',
    PackageSource={
        'S3BucketName': 'string',
        'S3Key': 'string'
    },
    PackageDescription='string',
    CommitMessage='string'
)
type PackageID

string

param PackageID

[REQUIRED]

The unique identifier for the package.

type PackageSource

dict

param PackageSource

[REQUIRED]

Amazon S3 bucket and key for the package.

  • S3BucketName (string) --

    The name of the Amazon S3 bucket containing the package.

  • S3Key (string) --

    Key (file name) of the package.

type PackageDescription

string

param PackageDescription

A new description of the package.

type CommitMessage

string

param CommitMessage

Commit message for the updated file, which is shown as part of GetPackageVersionHistoryResponse .

rtype

dict

returns

Response Syntax

{
    'PackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY'|'ZIP-PLUGIN',
        'PackageDescription': 'string',
        'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'AvailablePackageVersion': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        },
        'EngineVersion': 'string',
        'AvailablePluginProperties': {
            'Name': 'string',
            'Description': 'string',
            'Version': 'string',
            'ClassName': 'string',
            'UncompressedSizeInBytes': 123
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by the UpdatePackage operation.

    • PackageDetails (dict) --

      Information about a package.

      • PackageID (string) --

        The unique identifier of the package.

      • PackageName (string) --

        The user-specified name of the package.

      • PackageType (string) --

        The type of package.

      • PackageDescription (string) --

        User-specified description of the package.

      • PackageStatus (string) --

        The current status of the package. The available options are AVAILABLE , COPYING , COPY_FAILED , VALIDATNG , VALIDATION_FAILED , DELETING , and DELETE_FAILED .

      • CreatedAt (datetime) --

        The timestamp when the package was created.

      • LastUpdatedAt (datetime) --

        Date and time when the package was last updated.

      • AvailablePackageVersion (string) --

        The package version.

      • 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.

      • EngineVersion (string) --

        Version of OpenSearch or Elasticsearch, in the format Elasticsearch_X.Y or OpenSearch_X.Y. Defaults to the latest version of OpenSearch.

      • AvailablePluginProperties (dict) --

        If the package is a ZIP-PLUGIN package, additional information about plugin properties.

        • Name (string) --

          The name of the plugin.

        • Description (string) --

          The description of the plugin.

        • Version (string) --

          The version of the plugin.

        • ClassName (string) --

          The name of the class to load.

        • UncompressedSizeInBytes (integer) --

          The uncompressed size of the plugin.