DataZone / Client / get_subscription

get_subscription#

DataZone.Client.get_subscription(**kwargs)#

Gets a subscription in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

response = client.get_subscription(
    domainIdentifier='string',
    identifier='string'
)
Parameters:
  • domainIdentifier (string) –

    [REQUIRED]

    The ID of the Amazon DataZone domain in which the subscription exists.

  • identifier (string) –

    [REQUIRED]

    The ID of the subscription.

Return type:

dict

Returns:

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'id': 'string',
    'retainPermissions': True|False,
    'status': 'APPROVED'|'REVOKED'|'CANCELLED',
    'subscribedListing': {
        'description': 'string',
        'id': 'string',
        'item': {
            'assetListing': {
                'entityId': 'string',
                'entityRevision': 'string',
                'entityType': 'string',
                'forms': 'string',
                'glossaryTerms': [
                    {
                        'name': 'string',
                        'shortDescription': 'string'
                    },
                ]
            },
            'productListing': {
                'assetListings': [
                    {
                        'entityId': 'string',
                        'entityRevision': 'string',
                        'entityType': 'string'
                    },
                ],
                'description': 'string',
                'entityId': 'string',
                'entityRevision': 'string',
                'glossaryTerms': [
                    {
                        'name': 'string',
                        'shortDescription': 'string'
                    },
                ],
                'name': 'string'
            }
        },
        'name': 'string',
        'ownerProjectId': 'string',
        'ownerProjectName': 'string',
        'revision': 'string'
    },
    'subscribedPrincipal': {
        'project': {
            'id': 'string',
            'name': 'string'
        }
    },
    'subscriptionRequestId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) –

    • createdAt (datetime) –

      The timestamp of when the subscription was created.

    • createdBy (string) –

      The Amazon DataZone user who created the subscription.

    • domainId (string) –

      The ID of the Amazon DataZone domain in which the subscription exists.

    • id (string) –

      The ID of the subscription.

    • retainPermissions (boolean) –

      The retain permissions of the subscription.

    • status (string) –

      The status of the subscription.

    • subscribedListing (dict) –

      The details of the published asset for which the subscription grant is created.

      • description (string) –

        The description of the published asset for which the subscription grant is created.

      • id (string) –

        The identifier of the published asset for which the subscription grant is created.

      • item (dict) –

        The published asset for which the subscription grant is created.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: assetListing, productListing. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        
        • assetListing (dict) –

          The asset for which the subscription grant is created.

          • entityId (string) –

            The identifier of the published asset for which the subscription grant is created.

          • entityRevision (string) –

            The revision of the published asset for which the subscription grant is created.

          • entityType (string) –

            The type of the published asset for which the subscription grant is created.

          • forms (string) –

            The forms attached to the published asset for which the subscription grant is created.

          • glossaryTerms (list) –

            The glossary terms attached to the published asset for which the subscription grant is created.

            • (dict) –

              Details of a glossary term attached to the inventory asset.

              • name (string) –

                The name of a glossary term attached to the inventory asset.

              • shortDescription (string) –

                The shoft description of a glossary term attached to the inventory asset.

        • productListing (dict) –

          The data product listing.

          • assetListings (list) –

            The data assets of the data product listing.

            • (dict) –

              The listing of the asset in a data product.

              • entityId (string) –

                The entity ID of the listing of the asset in a data product.

              • entityRevision (string) –

                The entity revision of the listing of the asset in a data product.

              • entityType (string) –

                The entity type of the listing of the asset in a data product.

          • description (string) –

            The description of the data product listing.

          • entityId (string) –

            The ID of the data product listing.

          • entityRevision (string) –

            The revision of the data product listing.

          • glossaryTerms (list) –

            The glossary terms of the data product listing.

            • (dict) –

              Details of a glossary term attached to the inventory asset.

              • name (string) –

                The name of a glossary term attached to the inventory asset.

              • shortDescription (string) –

                The shoft description of a glossary term attached to the inventory asset.

          • name (string) –

            The name of the data product listing.

      • name (string) –

        The name of the published asset for which the subscription grant is created.

      • ownerProjectId (string) –

        The identifier of the project of the published asset for which the subscription grant is created.

      • ownerProjectName (string) –

        The name of the project that owns the published asset for which the subscription grant is created.

      • revision (string) –

        The revision of the published asset for which the subscription grant is created.

    • subscribedPrincipal (dict) –

      The principal that owns the subscription.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: project. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

      'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
      
      • project (dict) –

        The project that has the subscription grant.

        • id (string) –

          The identifier of the project that has the subscription grant.

        • name (string) –

          The name of the project that has the subscription grant.

    • subscriptionRequestId (string) –

      The ID of the subscription request.

    • updatedAt (datetime) –

      The timestamp of when the subscription was updated.

    • updatedBy (string) –

      The Amazon DataZone user who updated the subscription.

Exceptions

  • DataZone.Client.exceptions.InternalServerException

  • DataZone.Client.exceptions.ResourceNotFoundException

  • DataZone.Client.exceptions.AccessDeniedException

  • DataZone.Client.exceptions.ThrottlingException

  • DataZone.Client.exceptions.ValidationException

  • DataZone.Client.exceptions.UnauthorizedException