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': {
                'assetScope': {
                    'assetId': 'string',
                    'errorMessage': 'string',
                    'filterIds': [
                        'string',
                    ],
                    'status': 'string'
                },
                '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.

        • assetScope (dict) –

          The asset scope of the subscribed asset listing.

          • assetId (string) –

            The asset ID of the asset scope.

          • errorMessage (string) –

            The error message of the asset scope.

          • filterIds (list) –

            The filter IDs of the asset scope.

            • (string) –

          • status (string) –

            The status of the asset scope.

        • 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