Amazon DataZone

2023/10/04 - Amazon DataZone - 99 new api methods

Changes  Initial release of Amazon DataZone

GetSubscription (new) Link ¶

Gets a subscription in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_subscription(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

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

type identifier

string

param identifier

[REQUIRED]

The ID of the subscription.

rtype

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'
                    },
                ]
            }
        },
        '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) --

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

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

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

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

ListEnvironmentProfiles (new) Link ¶

Lists Amazon DataZone environment profiles.

See also: AWS API Documentation

Request Syntax

client.list_environment_profiles(
    awsAccountId='string',
    awsAccountRegion='string',
    domainIdentifier='string',
    environmentBlueprintIdentifier='string',
    maxResults=123,
    name='string',
    nextToken='string',
    projectIdentifier='string'
)
type awsAccountId

string

param awsAccountId

The identifier of the Amazon Web Services account where you want to list environment profiles.

type awsAccountRegion

string

param awsAccountRegion

The Amazon Web Services region where you want to list environment profiles.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type environmentBlueprintIdentifier

string

param environmentBlueprintIdentifier

The identifier of the blueprint that was used to create the environment profiles that you want to list.

type maxResults

integer

param maxResults

The maximum number of environment profiles to return in a single call to ListEnvironmentProfiles . When the number of environment profiles to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListEnvironmentProfiles to list the next set of environment profiles.

type name

string

param name

type nextToken

string

param nextToken

When the number of environment profiles is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of environment profiles, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironmentProfiles to list the next set of environment profiles.

type projectIdentifier

string

param projectIdentifier

The identifier of the Amazon DataZone project.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'awsAccountId': 'string',
            'awsAccountRegion': 'string',
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'description': 'string',
            'domainId': 'string',
            'environmentBlueprintId': 'string',
            'id': 'string',
            'name': 'string',
            'projectId': 'string',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListEnvironmentProfiles action.

      • (dict) --

        The details of an environment profile.

        • awsAccountId (string) --

          The identifier of an Amazon Web Services account in which an environment profile exists.

        • awsAccountRegion (string) --

          The Amazon Web Services Region in which an environment profile exists.

        • createdAt (datetime) --

          The timestamp of when an environment profile was created.

        • createdBy (string) --

          The Amazon DataZone user who created the environment profile.

        • description (string) --

          The description of the environment profile.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which the environment profile exists.

        • environmentBlueprintId (string) --

          The identifier of a blueprint with which an environment profile is created.

        • id (string) --

          The identifier of the environment profile.

        • name (string) --

          The name of the environment profile.

        • projectId (string) --

          The identifier of a project in which an environment profile exists.

        • updatedAt (datetime) --

          The timestamp of when the environment profile was updated.

    • nextToken (string) --

      When the number of environment profiles is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of environment profiles, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironmentProfiles to list the next set of environment profiles.

CreateGlossaryTerm (new) Link ¶

Creates a business glossary term.

See also: AWS API Documentation

Request Syntax

client.create_glossary_term(
    clientToken='string',
    domainIdentifier='string',
    glossaryIdentifier='string',
    longDescription='string',
    name='string',
    shortDescription='string',
    status='ENABLED'|'DISABLED',
    termRelations={
        'classifies': [
            'string',
        ],
        'isA': [
            'string',
        ]
    }
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this business glossary term is created.

type glossaryIdentifier

string

param glossaryIdentifier

[REQUIRED]

The ID of the business glossary in which this term is created.

type longDescription

string

param longDescription

The long description of this business glossary term.

type name

string

param name

[REQUIRED]

The name of this business glossary term.

type shortDescription

string

param shortDescription

The short description of this business glossary term.

type status

string

param status

The status of this business glossary term.

type termRelations

dict

param termRelations

The term relations of this business glossary term.

  • classifies (list) --

    The classifies of the term relations.

    • (string) --

  • isA (list) --

    The isA property of the term relations.

    • (string) --

rtype

dict

returns

Response Syntax

{
    'domainId': 'string',
    'glossaryId': 'string',
    'id': 'string',
    'longDescription': 'string',
    'name': 'string',
    'shortDescription': 'string',
    'status': 'ENABLED'|'DISABLED',
    'termRelations': {
        'classifies': [
            'string',
        ],
        'isA': [
            'string',
        ]
    }
}

Response Structure

  • (dict) --

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this business glossary term is created.

    • glossaryId (string) --

      The ID of the business glossary in which this term is created.

    • id (string) --

      The ID of this business glossary term.

    • longDescription (string) --

      The long description of this business glossary term.

    • name (string) --

      The name of this business glossary term.

    • shortDescription (string) --

      The short description of this business glossary term.

    • status (string) --

      The status of this business glossary term.

    • termRelations (dict) --

      The term relations of this business glossary term.

      • classifies (list) --

        The classifies of the term relations.

        • (string) --

      • isA (list) --

        The isA property of the term relations.

        • (string) --

CreateProjectMembership (new) Link ¶

Creates a project membership in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.create_project_membership(
    designation='PROJECT_OWNER'|'PROJECT_CONTRIBUTOR',
    domainIdentifier='string',
    member={
        'groupIdentifier': 'string',
        'userIdentifier': 'string'
    },
    projectIdentifier='string'
)
type designation

string

param designation

[REQUIRED]

The designation of the project membership.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which project membership is created.

type member

dict

param member

[REQUIRED]

The project member whose project membership was created.

  • groupIdentifier (string) --

    The ID of the group of a project member.

  • userIdentifier (string) --

    The user ID of a project member.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The ID of the project for which this project membership was created.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

DeleteProjectMembership (new) Link ¶

Deletes project membership in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_project_membership(
    domainIdentifier='string',
    member={
        'groupIdentifier': 'string',
        'userIdentifier': 'string'
    },
    projectIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain where project membership is deleted.

type member

dict

param member

[REQUIRED]

The project member whose project membership is deleted.

  • groupIdentifier (string) --

    The ID of the group of a project member.

  • userIdentifier (string) --

    The user ID of a project member.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The ID of the Amazon DataZone project the membership to which is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

ListEnvironments (new) Link ¶

Lists Amazon DataZone environments.

See also: AWS API Documentation

Request Syntax

client.list_environments(
    awsAccountId='string',
    awsAccountRegion='string',
    domainIdentifier='string',
    environmentBlueprintIdentifier='string',
    environmentProfileIdentifier='string',
    maxResults=123,
    name='string',
    nextToken='string',
    projectIdentifier='string',
    provider='string',
    status='ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'|'VALIDATION_FAILED'|'SUSPENDED'|'DISABLED'|'EXPIRED'|'DELETED'|'INACCESSIBLE'
)
type awsAccountId

string

param awsAccountId

The identifier of the Amazon Web Services account where you want to list environments.

type awsAccountRegion

string

param awsAccountRegion

The Amazon Web Services region where you want to list environments.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type environmentBlueprintIdentifier

string

param environmentBlueprintIdentifier

The identifier of the Amazon DataZone blueprint.

type environmentProfileIdentifier

string

param environmentProfileIdentifier

The identifier of the environment profile.

type maxResults

integer

param maxResults

The maximum number of environments to return in a single call to ListEnvironments . When the number of environments to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListEnvironments to list the next set of environments.

type name

string

param name

type nextToken

string

param nextToken

When the number of environments is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of environments, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironments to list the next set of environments.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The identifier of the Amazon DataZone project.

type provider

string

param provider

The provider of the environment.

type status

string

param status

The status of the environments that you want to list.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'awsAccountId': 'string',
            'awsAccountRegion': 'string',
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'description': 'string',
            'domainId': 'string',
            'environmentProfileId': 'string',
            'id': 'string',
            'name': 'string',
            'projectId': 'string',
            'provider': 'string',
            'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'|'VALIDATION_FAILED'|'SUSPENDED'|'DISABLED'|'EXPIRED'|'DELETED'|'INACCESSIBLE',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListEnvironments action.

      • (dict) --

        The details of an environment.

        • awsAccountId (string) --

          The identifier of the Amazon Web Services account in which an environment exists.

        • awsAccountRegion (string) --

          The Amazon Web Services Region in which an environment exists.

        • createdAt (datetime) --

          The timestamp of when the environment was created.

        • createdBy (string) --

          The Amazon DataZone user who created the environment.

        • description (string) --

          The description of the environment.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which the environment exists.

        • environmentProfileId (string) --

          The identifier of the environment profile with which the environment was created.

        • id (string) --

          The identifier of the environment.

        • name (string) --

          The name of the environment.

        • projectId (string) --

          The identifier of the project in which the environment exists.

        • provider (string) --

          The provider of the environment.

        • status (string) --

          The status of the environment.

        • updatedAt (datetime) --

          The timestamp of when the environment was updated.

    • nextToken (string) --

      When the number of environments is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of environments, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironments to list the next set of environments.

ListSubscriptions (new) Link ¶

Lists subscriptions in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.list_subscriptions(
    approverProjectId='string',
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    owningProjectId='string',
    sortBy='CREATED_AT'|'UPDATED_AT',
    sortOrder='ASCENDING'|'DESCENDING',
    status='APPROVED'|'REVOKED'|'CANCELLED',
    subscribedListingId='string',
    subscriptionRequestIdentifier='string'
)
type approverProjectId

string

param approverProjectId

The identifier of the project for the subscription's approver.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type maxResults

integer

param maxResults

The maximum number of subscriptions to return in a single call to ListSubscriptions . When the number of subscriptions to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListSubscriptions to list the next set of Subscriptions.

type nextToken

string

param nextToken

When the number of subscriptions is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscriptions, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptions to list the next set of subscriptions.

type owningProjectId

string

param owningProjectId

The identifier of the owning project.

type sortBy

string

param sortBy

Specifies the way in which the results of this action are to be sorted.

type sortOrder

string

param sortOrder

Specifies the sort order for the results of this action.

type status

string

param status

The status of the subscriptions that you want to list.

type subscribedListingId

string

param subscribedListingId

The identifier of the subscribed listing for the subscriptions that you want to list.

type subscriptionRequestIdentifier

string

param subscriptionRequestIdentifier

The identifier of the subscription request for the subscriptions that you want to list.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            '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'
                            },
                        ]
                    }
                },
                'name': 'string',
                'ownerProjectId': 'string',
                'ownerProjectName': 'string',
                'revision': 'string'
            },
            'subscribedPrincipal': {
                'project': {
                    'id': 'string',
                    'name': 'string'
                }
            },
            'subscriptionRequestId': 'string',
            'updatedAt': datetime(2015, 1, 1),
            'updatedBy': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListSubscriptions action.

      • (dict) --

        The details of the subscription.

        • createdAt (datetime) --

          The timestamp of when the subscription was created.

        • createdBy (string) --

          The Amazon DataZone user who created the subscription.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which a subscription exists.

        • id (string) --

          The identifier of the subscription.

        • retainPermissions (boolean) --

          The retain permissions included in the subscription.

        • status (string) --

          The status of the subscription.

        • subscribedListing (dict) --

          The listing included in the subscription.

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

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

          • 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 included in the subscription.

          • 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 identifier of the subscription request for the subscription.

        • updatedAt (datetime) --

          The timestamp of when the subscription was updated.

        • updatedBy (string) --

          The Amazon DataZone user who updated the subscription.

    • nextToken (string) --

      When the number of subscriptions is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscriptions, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptions to list the next set of subscriptions.

SearchUserProfiles (new) Link ¶

Searches user profiles in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.search_user_profiles(
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    searchText='string',
    userType='SSO_USER'|'DATAZONE_USER'|'DATAZONE_SSO_USER'|'DATAZONE_IAM_USER'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which you want to search user profiles.

type maxResults

integer

param maxResults

The maximum number of results to return in a single call to SearchUserProfiles . When the number of results to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to SearchUserProfiles to list the next set of results.

type nextToken

string

param nextToken

When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchUserProfiles to list the next set of results.

type searchText

string

param searchText

Specifies the text for which to search.

type userType

string

param userType

[REQUIRED]

Specifies the user type for the SearchUserProfiles action.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'details': {
                'iam': {
                    'arn': 'string'
                },
                'sso': {
                    'firstName': 'string',
                    'lastName': 'string',
                    'username': 'string'
                }
            },
            'domainId': 'string',
            'id': 'string',
            'status': 'ASSIGNED'|'NOT_ASSIGNED'|'ACTIVATED'|'DEACTIVATED',
            'type': 'IAM'|'SSO'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the SearchUserProfiles action.

      • (dict) --

        The details of the user profile.

        • details (dict) --

          The details of the user profile.

          • iam (dict) --

            The IAM details included in the user profile details.

            • arn (string) --

              The ARN of an IAM user profile in Amazon DataZone.

          • sso (dict) --

            The single sign-on details included in the user profile details.

            • firstName (string) --

              The first name included in the single sign-on details of the user profile.

            • lastName (string) --

              The last name included in the single sign-on details of the user profile.

            • username (string) --

              The username included in the single sign-on details of the user profile.

        • domainId (string) --

          The ID of the Amazon DataZone domain of the user profile.

        • id (string) --

          The ID of the user profile.

        • status (string) --

          The status of the user profile.

        • type (string) --

          The type of the user profile.

    • nextToken (string) --

      When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchUserProfiles to list the next set of results.

ListSubscriptionTargets (new) Link ¶

Lists subscription targets in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.list_subscription_targets(
    domainIdentifier='string',
    environmentIdentifier='string',
    maxResults=123,
    nextToken='string',
    sortBy='CREATED_AT'|'UPDATED_AT',
    sortOrder='ASCENDING'|'DESCENDING'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain where you want to list subscription targets.

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The identifier of the environment where you want to list subscription targets.

type maxResults

integer

param maxResults

The maximum number of subscription targets to return in a single call to ListSubscriptionTargets . When the number of subscription targets to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListSubscriptionTargets to list the next set of subscription targets.

type nextToken

string

param nextToken

When the number of subscription targets is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscription targets, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptionTargets to list the next set of subscription targets.

type sortBy

string

param sortBy

Specifies the way in which the results of this action are to be sorted.

type sortOrder

string

param sortOrder

Specifies the sort order for the results of this action.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'applicableAssetTypes': [
                'string',
            ],
            'authorizedPrincipals': [
                'string',
            ],
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'domainId': 'string',
            'environmentId': 'string',
            'id': 'string',
            'manageAccessRole': 'string',
            'name': 'string',
            'projectId': 'string',
            'provider': 'string',
            'subscriptionTargetConfig': [
                {
                    'content': 'string',
                    'formName': 'string'
                },
            ],
            'type': 'string',
            'updatedAt': datetime(2015, 1, 1),
            'updatedBy': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListSubscriptionTargets action.

      • (dict) --

        The details of the subscription target.

        • applicableAssetTypes (list) --

          The asset types included in the subscription target.

          • (string) --

        • authorizedPrincipals (list) --

          The authorized principals included in the subscription target.

          • (string) --

        • createdAt (datetime) --

          The timestamp of when the subscription target was created.

        • createdBy (string) --

          The Amazon DataZone user who created the subscription target.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which the subscription target exists.

        • environmentId (string) --

          The identifier of the environment of the subscription target.

        • id (string) --

          The identifier of the subscription target.

        • manageAccessRole (string) --

          The manage access role specified in the subscription target.

        • name (string) --

          The name of the subscription target.

        • projectId (string) --

          The identifier of the project specified in the subscription target.

        • provider (string) --

          The provider of the subscription target.

        • subscriptionTargetConfig (list) --

          The configuration of the subscription target.

          • (dict) --

            The details of the subscription target configuration.

            • content (string) --

              The content of the subscription target configuration.

            • formName (string) --

              The form name included in the subscription target configuration.

        • type (string) --

          The type of the subscription target.

        • updatedAt (datetime) --

          The timestamp of when the subscription target was updated.

        • updatedBy (string) --

          The Amazon DataZone user who updated the subscription target.

    • nextToken (string) --

      When the number of subscription targets is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscription targets, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptionTargets to list the next set of subscription targets.

UpdateGlossary (new) Link ¶

Updates the business glossary in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_glossary(
    clientToken='string',
    description='string',
    domainIdentifier='string',
    identifier='string',
    name='string',
    status='DISABLED'|'ENABLED'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type description

string

param description

The description to be updated as part of the UpdateGlossary action.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a business glossary is to be updated.

type identifier

string

param identifier

[REQUIRED]

The identifier of the business glossary to be updated.

type name

string

param name

The name to be updated as part of the UpdateGlossary action.

type status

string

param status

The status to be updated as part of the UpdateGlossary action.

rtype

dict

returns

Response Syntax

{
    'description': 'string',
    'domainId': 'string',
    'id': 'string',
    'name': 'string',
    'owningProjectId': 'string',
    'status': 'DISABLED'|'ENABLED'
}

Response Structure

  • (dict) --

    • description (string) --

      The description to be updated as part of the UpdateGlossary action.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a business glossary is to be updated.

    • id (string) --

      The identifier of the business glossary that is to be updated.

    • name (string) --

      The name to be updated as part of the UpdateGlossary action.

    • owningProjectId (string) --

      The identifier of the project in which to update a business glossary.

    • status (string) --

      The status to be updated as part of the UpdateGlossary action.

CreateDataSource (new) Link ¶

Creates an Amazon DataZone data source.

See also: AWS API Documentation

Request Syntax

client.create_data_source(
    assetFormsInput=[
        {
            'content': 'string',
            'formName': 'string',
            'typeIdentifier': 'string',
            'typeRevision': 'string'
        },
    ],
    clientToken='string',
    configuration={
        'glueRunConfiguration': {
            'dataAccessRole': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        },
        'redshiftRunConfiguration': {
            'dataAccessRole': 'string',
            'redshiftCredentialConfiguration': {
                'secretManagerArn': 'string'
            },
            'redshiftStorage': {
                'redshiftClusterSource': {
                    'clusterName': 'string'
                },
                'redshiftServerlessSource': {
                    'workgroupName': 'string'
                }
            },
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        }
    },
    description='string',
    domainIdentifier='string',
    enableSetting='ENABLED'|'DISABLED',
    environmentIdentifier='string',
    name='string',
    projectIdentifier='string',
    publishOnImport=True|False,
    recommendation={
        'enableBusinessNameGeneration': True|False
    },
    schedule={
        'schedule': 'string',
        'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
    },
    type='string'
)
type assetFormsInput

list

param assetFormsInput

The metadata forms that are to be attached to the assets that this data source works with.

  • (dict) --

    The details of a metadata form.

    • content (string) --

      The content of the metadata form.

    • formName (string) -- [REQUIRED]

      The name of the metadata form.

    • typeIdentifier (string) --

      The ID of the metadata form type.

    • typeRevision (string) --

      The revision of the metadata form type.

type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type configuration

dict

param configuration

Specifies the configuration of the data source. It can be set to either glueRunConfiguration or redshiftRunConfiguration .

  • glueRunConfiguration (dict) --

    The configuration of the Amazon Web Services Glue data source.

    • dataAccessRole (string) --

      The data access role included in the configuration details of the Amazon Web Services Glue data source.

    • relationalFilterConfigurations (list) -- [REQUIRED]

      The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.

      • (dict) --

        The relational filter configuration for the data source.

        • databaseName (string) -- [REQUIRED]

          The database name specified in the relational filter configuration for the data source.

        • filterExpressions (list) --

          The filter expressions specified in the relational filter configuration for the data source.

          • (dict) --

            A filter expression in Amazon DataZone.

            • expression (string) -- [REQUIRED]

              The search filter expression.

            • type (string) -- [REQUIRED]

              The search filter explresison type.

        • schemaName (string) --

          The schema name specified in the relational filter configuration for the data source.

  • redshiftRunConfiguration (dict) --

    The configuration of the Amazon Redshift data source.

    • dataAccessRole (string) --

      The data access role included in the configuration details of the Amazon Redshift data source.

    • redshiftCredentialConfiguration (dict) -- [REQUIRED]

      The details of the credentials required to access an Amazon Redshift cluster.

      • secretManagerArn (string) -- [REQUIRED]

        The ARN of a secret manager for an Amazon Redshift cluster.

    • redshiftStorage (dict) -- [REQUIRED]

      The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.

      • redshiftClusterSource (dict) --

        The details of the Amazon Redshift cluster source.

        • clusterName (string) -- [REQUIRED]

          The name of an Amazon Redshift cluster.

      • redshiftServerlessSource (dict) --

        The details of the Amazon Redshift Serverless workgroup source.

        • workgroupName (string) -- [REQUIRED]

          The name of the Amazon Redshift Serverless workgroup.

    • relationalFilterConfigurations (list) -- [REQUIRED]

      The relational filger configurations included in the configuration details of the Amazon Redshift data source.

      • (dict) --

        The relational filter configuration for the data source.

        • databaseName (string) -- [REQUIRED]

          The database name specified in the relational filter configuration for the data source.

        • filterExpressions (list) --

          The filter expressions specified in the relational filter configuration for the data source.

          • (dict) --

            A filter expression in Amazon DataZone.

            • expression (string) -- [REQUIRED]

              The search filter expression.

            • type (string) -- [REQUIRED]

              The search filter explresison type.

        • schemaName (string) --

          The schema name specified in the relational filter configuration for the data source.

type description

string

param description

The description of the data source.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain where the data source is created.

type enableSetting

string

param enableSetting

Specifies whether the data source is enabled.

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The unique identifier of the Amazon DataZone environment to which the data source publishes assets.

type name

string

param name

[REQUIRED]

The name of the data source.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The identifier of the Amazon DataZone project in which you want to add this data source.

type publishOnImport

boolean

param publishOnImport

Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.

type recommendation

dict

param recommendation

Specifies whether the business name generation is to be enabled for this data source.

  • enableBusinessNameGeneration (boolean) --

    Specifies whether automatic business name generation is to be enabled or not as part of the recommendation configuration.

type schedule

dict

param schedule

The schedule of the data source runs.

  • schedule (string) --

    The schedule of the data source runs.

  • timezone (string) --

    The timezone of the data source run.

type type

string

param type

[REQUIRED]

The type of the data source.

rtype

dict

returns

Response Syntax

{
    'assetFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'configuration': {
        'glueRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        },
        'redshiftRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'redshiftCredentialConfiguration': {
                'secretManagerArn': 'string'
            },
            'redshiftStorage': {
                'redshiftClusterSource': {
                    'clusterName': 'string'
                },
                'redshiftServerlessSource': {
                    'workgroupName': 'string'
                }
            },
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        }
    },
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'domainId': 'string',
    'enableSetting': 'ENABLED'|'DISABLED',
    'environmentId': 'string',
    'errorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'id': 'string',
    'lastRunAt': datetime(2015, 1, 1),
    'lastRunErrorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'lastRunStatus': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
    'name': 'string',
    'projectId': 'string',
    'publishOnImport': True|False,
    'recommendation': {
        'enableBusinessNameGeneration': True|False
    },
    'schedule': {
        'schedule': 'string',
        'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
    },
    'status': 'CREATING'|'FAILED_CREATION'|'READY'|'UPDATING'|'FAILED_UPDATE'|'RUNNING'|'DELETING'|'FAILED_DELETION',
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • assetFormsOutput (list) --

      The metadata forms attached to the assets that this data source creates.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • configuration (dict) --

      Specifies the configuration of the data source. It can be set to either glueRunConfiguration or redshiftRunConfiguration .

      • glueRunConfiguration (dict) --

        The configuration of the Amazon Web Services Glue data source.

        • accountId (string) --

          The Amazon Web Services account ID included in the configuration details of the Amazon Web Services Glue data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Web Services Glue data source.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Web Services Glue data source.

        • relationalFilterConfigurations (list) --

          The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

      • redshiftRunConfiguration (dict) --

        The configuration of the Amazon Redshift data source.

        • accountId (string) --

          The ID of the Amazon Web Services account included in the configuration details of the Amazon Redshift data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Redshift data source.

        • redshiftCredentialConfiguration (dict) --

          The details of the credentials required to access an Amazon Redshift cluster.

          • secretManagerArn (string) --

            The ARN of a secret manager for an Amazon Redshift cluster.

        • redshiftStorage (dict) --

          The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.

          • redshiftClusterSource (dict) --

            The details of the Amazon Redshift cluster source.

            • clusterName (string) --

              The name of an Amazon Redshift cluster.

          • redshiftServerlessSource (dict) --

            The details of the Amazon Redshift Serverless workgroup source.

            • workgroupName (string) --

              The name of the Amazon Redshift Serverless workgroup.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Redshift data source.

        • relationalFilterConfigurations (list) --

          The relational filger configurations included in the configuration details of the Amazon Redshift data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

    • createdAt (datetime) --

      The timestamp of when the data source was created.

    • description (string) --

      The description of the data source.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the data source is created.

    • enableSetting (string) --

      Specifies whether the data source is enabled.

    • environmentId (string) --

      The unique identifier of the Amazon DataZone environment to which the data source publishes assets.

    • errorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • id (string) --

      The unique identifier of the data source.

    • lastRunAt (datetime) --

      The timestamp that specifies when the data source was last run.

    • lastRunErrorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • lastRunStatus (string) --

      The status of the last run of this data source.

    • name (string) --

      The name of the data source.

    • projectId (string) --

      The ID of the Amazon DataZone project to which the data source is added.

    • publishOnImport (boolean) --

      Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.

    • recommendation (dict) --

      Specifies whether the business name generation is to be enabled for this data source.

      • enableBusinessNameGeneration (boolean) --

        Specifies whether automatic business name generation is to be enabled or not as part of the recommendation configuration.

    • schedule (dict) --

      The schedule of the data source runs.

      • schedule (string) --

        The schedule of the data source runs.

      • timezone (string) --

        The timezone of the data source run.

    • status (string) --

      The status of the data source.

    • type (string) --

      The type of the data source.

    • updatedAt (datetime) --

      The timestamp of when the data source was updated.

DeleteAsset (new) Link ¶

Delets an asset in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_asset(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the asset is deleted.

type identifier

string

param identifier

[REQUIRED]

The identifier of the asset that is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

UntagResource (new) Link ¶

Untags a resource in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.untag_resource(
    resourceArn='string',
    tagKeys=[
        'string',
    ]
)
type resourceArn

string

param resourceArn

[REQUIRED]

The ARN of the resource to be untagged in Amazon DataZone.

type tagKeys

list

param tagKeys

[REQUIRED]

Specifies the tag keys for the UntagResource action.

  • (string) --

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

SearchListings (new) Link ¶

Searches listings in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.search_listings(
    additionalAttributes=[
        'FORMS',
    ],
    domainIdentifier='string',
    filters={
        'and': [
            {'... recursive ...'},
        ],
        'filter': {
            'attribute': 'string',
            'value': 'string'
        },
        'or': [
            {'... recursive ...'},
        ]
    },
    maxResults=123,
    nextToken='string',
    searchIn=[
        {
            'attribute': 'string'
        },
    ],
    searchText='string',
    sort={
        'attribute': 'string',
        'order': 'ASCENDING'|'DESCENDING'
    }
)
type additionalAttributes

list

param additionalAttributes

Specifies additional attributes for the search.

  • (string) --

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the domain in which to search listings.

type filters

dict

param filters

Specifies the filters for the search of listings.

  • and (list) --

    The 'and' search filter clause in Amazon DataZone.

    • (dict) --

      A search filter clause in Amazon DataZone.

  • filter (dict) --

    A search filter in Amazon DataZone.

    • attribute (string) -- [REQUIRED]

      A search filter attribute in Amazon DataZone.

    • value (string) -- [REQUIRED]

      A search filter value in Amazon DataZone.

  • or (list) --

    The 'or' search filter clause in Amazon DataZone.

    • (dict) --

      A search filter clause in Amazon DataZone.

type maxResults

integer

param maxResults

The maximum number of results to return in a single call to SearchListings . When the number of results to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to SearchListings to list the next set of results.

type nextToken

string

param nextToken

When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchListings to list the next set of results.

type searchIn

list

param searchIn
  • (dict) --

    The details of the search.

    • attribute (string) -- [REQUIRED]

      The search attribute.

type searchText

string

param searchText

Specifies the text for which to search.

type sort

dict

param sort

Specifies the way for sorting the search results.

  • attribute (string) -- [REQUIRED]

    The attribute detail of the way to sort search results.

  • order (string) --

    The order detail of the wya to sort search results.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'assetListing': {
                'additionalAttributes': {
                    'forms': 'string'
                },
                'createdAt': datetime(2015, 1, 1),
                'description': 'string',
                'entityId': 'string',
                'entityRevision': 'string',
                'entityType': 'string',
                'glossaryTerms': [
                    {
                        'name': 'string',
                        'shortDescription': 'string'
                    },
                ],
                'listingCreatedBy': 'string',
                'listingId': 'string',
                'listingRevision': 'string',
                'listingUpdatedBy': 'string',
                'name': 'string',
                'owningProjectId': 'string'
            }
        },
    ],
    'nextToken': 'string',
    'totalMatchCount': 123
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the SearchListings action.

      • (dict) --

        The details of the results of the SearchListings action.

        • assetListing (dict) --

          The asset listing included in the results of the SearchListings action.

          • additionalAttributes (dict) --

            The additional attributes of an asset published in an Amazon DataZone catalog.

            • forms (string) --

              The metadata forms that form additional attributes of the metadata asset.

          • createdAt (datetime) --

            The timestamp of when an asset published in an Amazon DataZone catalog was created.

          • description (string) --

            The description of an asset published in an Amazon DataZone catalog.

          • entityId (string) --

            The identifier of the inventory asset.

          • entityRevision (string) --

            The revision of the inventory asset.

          • entityType (string) --

            The type of the inventory asset.

          • glossaryTerms (list) --

            Glossary terms attached to the inventory asset.

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

          • listingCreatedBy (string) --

            The Amazon DataZone user who created the listing.

          • listingId (string) --

            The identifier of the listing (asset published in Amazon DataZone catalog).

          • listingRevision (string) --

            The revision of the listing (asset published in Amazon DataZone catalog).

          • listingUpdatedBy (string) --

            The Amazon DataZone user who updated the listing.

          • name (string) --

            The name of the inventory asset.

          • owningProjectId (string) --

            The identifier of the project that owns the inventory asset.

    • nextToken (string) --

      When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchListings to list the next set of results.

    • totalMatchCount (integer) --

      Total number of search results.

UpdateSubscriptionRequest (new) Link ¶

Updates a specified subscription request in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_subscription_request(
    domainIdentifier='string',
    identifier='string',
    requestReason='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a subscription request is to be updated.

type identifier

string

param identifier

[REQUIRED]

The identifier of the subscription request that is to be updated.

type requestReason

string

param requestReason

[REQUIRED]

The reason for the UpdateSubscriptionRequest action.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'decisionComment': 'string',
    'domainId': 'string',
    'id': 'string',
    'requestReason': 'string',
    'reviewerId': 'string',
    'status': 'PENDING'|'ACCEPTED'|'REJECTED',
    'subscribedListings': [
        {
            'description': 'string',
            'id': 'string',
            'item': {
                'assetListing': {
                    'entityId': 'string',
                    'entityRevision': 'string',
                    'entityType': 'string',
                    'forms': 'string',
                    'glossaryTerms': [
                        {
                            'name': 'string',
                            'shortDescription': 'string'
                        },
                    ]
                }
            },
            'name': 'string',
            'ownerProjectId': 'string',
            'ownerProjectName': 'string',
            'revision': 'string'
        },
    ],
    'subscribedPrincipals': [
        {
            'project': {
                'id': 'string',
                'name': 'string'
            }
        },
    ],
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the subscription request was created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription request.

    • decisionComment (string) --

      The decision comment of the UpdateSubscriptionRequest action.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a subscription request is to be updated.

    • id (string) --

      The identifier of the subscription request that is to be updated.

    • requestReason (string) --

      The reason for the UpdateSubscriptionRequest action.

    • reviewerId (string) --

      The identifier of the Amazon DataZone user who reviews the subscription request.

    • status (string) --

      The status of the subscription request.

    • subscribedListings (list) --

      The subscribed listings of the subscription request.

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

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

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

    • subscribedPrincipals (list) --

      The subscribed principals of the subscription request.

      • (dict) --

        The principal that has the subscription grant for the asset.

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

    • updatedAt (datetime) --

      The timestamp of when the subscription request was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription request.

CreateFormType (new) Link ¶

Creates a metadata form type.

See also: AWS API Documentation

Request Syntax

client.create_form_type(
    description='string',
    domainIdentifier='string',
    model={
        'smithy': 'string'
    },
    name='string',
    owningProjectIdentifier='string',
    status='ENABLED'|'DISABLED'
)
type description

string

param description

The description of this Amazon DataZone metadata form type.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this metadata form type is created.

type model

dict

param model

[REQUIRED]

The model of this Amazon DataZone metadata form type.

  • smithy (string) --

type name

string

param name

[REQUIRED]

The name of this Amazon DataZone metadata form type.

type owningProjectIdentifier

string

param owningProjectIdentifier

[REQUIRED]

The ID of the Amazon DataZone project that owns this metadata form type.

type status

string

param status

The status of this Amazon DataZone metadata form type.

rtype

dict

returns

Response Syntax

{
    'description': 'string',
    'domainId': 'string',
    'name': 'string',
    'originDomainId': 'string',
    'originProjectId': 'string',
    'owningProjectId': 'string',
    'revision': 'string'
}

Response Structure

  • (dict) --

    • description (string) --

      The description of this Amazon DataZone metadata form type.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this metadata form type is created.

    • name (string) --

      The name of this Amazon DataZone metadata form type.

    • originDomainId (string) --

      The ID of the Amazon DataZone domain in which this metadata form type was originally created.

    • originProjectId (string) --

      The ID of the project in which this Amazon DataZone metadata form type was originally created.

    • owningProjectId (string) --

      The ID of the project that owns this Amazon DataZone metadata form type.

    • revision (string) --

      The revision of this Amazon DataZone metadata form type.

AcceptSubscriptionRequest (new) Link ¶

Accepts a subscription request to a specific asset.

See also: AWS API Documentation

Request Syntax

client.accept_subscription_request(
    decisionComment='string',
    domainIdentifier='string',
    identifier='string'
)
type decisionComment

string

param decisionComment

A description that specifies the reason for accepting the specified subscription request.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The Amazon DataZone domain where the specified subscription request is being accepted.

type identifier

string

param identifier

[REQUIRED]

The unique identifier of the subscription request that is to be accepted.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'decisionComment': 'string',
    'domainId': 'string',
    'id': 'string',
    'requestReason': 'string',
    'reviewerId': 'string',
    'status': 'PENDING'|'ACCEPTED'|'REJECTED',
    'subscribedListings': [
        {
            'description': 'string',
            'id': 'string',
            'item': {
                'assetListing': {
                    'entityId': 'string',
                    'entityRevision': 'string',
                    'entityType': 'string',
                    'forms': 'string',
                    'glossaryTerms': [
                        {
                            'name': 'string',
                            'shortDescription': 'string'
                        },
                    ]
                }
            },
            'name': 'string',
            'ownerProjectId': 'string',
            'ownerProjectName': 'string',
            'revision': 'string'
        },
    ],
    'subscribedPrincipals': [
        {
            'project': {
                'id': 'string',
                'name': 'string'
            }
        },
    ],
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp that specifies when the subscription request was accepted.

    • createdBy (string) --

      Specifies the Amazon DataZone user that accepted the specified subscription request.

    • decisionComment (string) --

      Specifies the reason for accepting the subscription request.

    • domainId (string) --

      The unique identifier of the Amazon DataZone domain where the specified subscription request was accepted.

    • id (string) --

      The identifier of the subscription request.

    • requestReason (string) --

      Specifies the reason for requesting a subscription to the asset.

    • reviewerId (string) --

      Specifes the ID of the Amazon DataZone user who reviewed the subscription request.

    • status (string) --

      Specifies the status of the subscription request.

    • subscribedListings (list) --

      Specifies the asset for which the subscription request was created.

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

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

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

    • subscribedPrincipals (list) --

      Specifies the Amazon DataZone users who are subscribed to the asset specified in the subscription request.

      • (dict) --

        The principal that has the subscription grant for the asset.

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

    • updatedAt (datetime) --

      Specifies the timestamp when subscription request was updated.

    • updatedBy (string) --

      Specifies the Amazon DataZone user who updated the subscription request.

GetEnvironmentProfile (new) Link ¶

Gets an evinronment profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_environment_profile(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this environment profile exists.

type identifier

string

param identifier

[REQUIRED]

The ID of the environment profile.

rtype

dict

returns

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'environmentBlueprintId': 'string',
    'id': 'string',
    'name': 'string',
    'projectId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • awsAccountId (string) --

      The ID of the Amazon Web Services account where this environment profile exists.

    • awsAccountRegion (string) --

      The Amazon Web Services region where this environment profile exists.

    • createdAt (datetime) --

      The timestamp of when this environment profile was created.

    • createdBy (string) --

      The Amazon DataZone user who created this environment profile.

    • description (string) --

      The description of the environment profile.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this environment profile exists.

    • environmentBlueprintId (string) --

      The ID of the blueprint with which this environment profile is created.

    • id (string) --

      The ID of the environment profile.

    • name (string) --

      The name of the environment profile.

    • projectId (string) --

      The ID of the Amazon DataZone project in which this environment profile is created.

    • updatedAt (datetime) --

      The timestamp of when this environment profile was upated.

    • userParameters (list) --

      The user parameters of the environment profile.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

GetAssetType (new) Link ¶

Gets an Amazon DataZone asset type.

See also: AWS API Documentation

Request Syntax

client.get_asset_type(
    domainIdentifier='string',
    identifier='string',
    revision='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the asset type exists.

type identifier

string

param identifier

[REQUIRED]

The ID of the asset type.

type revision

string

param revision

The revision of the asset type.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'formsOutput': {
        'string': {
            'required': True|False,
            'typeName': 'string',
            'typeRevision': 'string'
        }
    },
    'name': 'string',
    'originDomainId': 'string',
    'originProjectId': 'string',
    'owningProjectId': 'string',
    'revision': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the asset type was created.

    • createdBy (string) --

      The Amazon DataZone user who created the asset type.

    • description (string) --

      The description of the asset type.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the asset type exists.

    • formsOutput (dict) --

      The metadata forms attached to the asset type.

      • (string) --

        • (dict) --

          The details of the form entry.

          • required (boolean) --

            Specifies whether a form entry is required.

          • typeName (string) --

            The name of the type of the form entry.

          • typeRevision (string) --

            The type revision of the form entry.

    • name (string) --

      The name of the asset type.

    • originDomainId (string) --

      The ID of the Amazon DataZone domain in which the asset type was originally created.

    • originProjectId (string) --

      The ID of the Amazon DataZone project in which the asset type was originally created.

    • owningProjectId (string) --

      The ID of the Amazon DataZone project that owns the asset type.

    • revision (string) --

      The revision of the asset type.

    • updatedAt (datetime) --

      The timestamp of when the asset type was updated.

    • updatedBy (string) --

      The Amazon DataZone user that updated the asset type.

DeleteSubscriptionGrant (new) Link ¶

Deletes and subscription grant in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_subscription_grant(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain where the subscription grant is deleted.

type identifier

string

param identifier

[REQUIRED]

The ID of the subscription grant that is deleted.

rtype

dict

returns

Response Syntax

{
    'assets': [
        {
            'assetId': 'string',
            'assetRevision': 'string',
            'failureCause': {
                'message': 'string'
            },
            'failureTimestamp': datetime(2015, 1, 1),
            'grantedTimestamp': datetime(2015, 1, 1),
            'status': 'GRANT_PENDING'|'REVOKE_PENDING'|'GRANT_IN_PROGRESS'|'REVOKE_IN_PROGRESS'|'GRANTED'|'REVOKED'|'GRANT_FAILED'|'REVOKE_FAILED',
            'targetName': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'grantedEntity': {
        'listing': {
            'id': 'string',
            'revision': 'string'
        }
    },
    'id': 'string',
    'status': 'PENDING'|'IN_PROGRESS'|'GRANT_FAILED'|'REVOKE_FAILED'|'GRANT_AND_REVOKE_FAILED'|'COMPLETED'|'INACCESSIBLE',
    'subscriptionId': 'string',
    'subscriptionTargetId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • assets (list) --

      The assets for which the subsctiption grant that is deleted gave access.

      • (dict) --

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

        • assetId (string) --

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

        • assetRevision (string) --

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

        • failureCause (dict) --

          The failure cause included in the details of the asset for which the subscription grant is created.

          • message (string) --

            The description of the error message.

        • failureTimestamp (datetime) --

          The failure timestamp included in the details of the asset for which the subscription grant is created.

        • grantedTimestamp (datetime) --

          The timestamp of when the subscription grant to the asset is created.

        • status (string) --

          The status of the asset for which the subscription grant is created.

        • targetName (string) --

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

    • createdAt (datetime) --

      The timestamp of when the subscription grant that is deleted was created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription grant that is deleted.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the subscription grant is deleted.

    • grantedEntity (dict) --

      The entity to which the subscription is deleted.

      • listing (dict) --

        The listing for which a subscription is granted.

        • id (string) --

          An identifier of a revision of an asset published in a Amazon DataZone catalog.

        • revision (string) --

          The details of a revision of an asset published in a Amazon DataZone catalog.

    • id (string) --

      The ID of the subscription grant that is deleted.

    • status (string) --

      The status of the subscription grant that is deleted.

    • subscriptionId (string) --

      The identifier of the subsctiption whose subscription grant is to be deleted.

    • subscriptionTargetId (string) --

      The ID of the subscription target associated with the subscription grant that is deleted.

    • updatedAt (datetime) --

      The timestamp of when the subscription grant that is deleted was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription grant that is deleted.

CreateEnvironment (new) Link ¶

Create an Amazon DataZone environment.

See also: AWS API Documentation

Request Syntax

client.create_environment(
    description='string',
    domainIdentifier='string',
    environmentProfileIdentifier='string',
    glossaryTerms=[
        'string',
    ],
    name='string',
    projectIdentifier='string',
    userParameters=[
        {
            'name': 'string',
            'value': 'string'
        },
    ]
)
type description

string

param description

The description of the Amazon DataZone environment.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which the environment is created.

type environmentProfileIdentifier

string

param environmentProfileIdentifier

[REQUIRED]

The identifier of the environment profile that is used to create this Amazon DataZone environment.

type glossaryTerms

list

param glossaryTerms

The glossary terms that can be used in this Amazon DataZone environment.

  • (string) --

type name

string

param name

[REQUIRED]

The name of the Amazon DataZone environment.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The identifier of the Amazon DataZone project in which this environment is created.

type userParameters

list

param userParameters

The user parameters of this Amazon DataZone environment.

  • (dict) --

    The parameter details of an evironment profile.

    • name (string) --

      The name of an environment profile parameter.

    • value (string) --

      The value of an environment profile parameter.

rtype

dict

returns

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'deploymentProperties': {
        'endTimeoutMinutes': 123,
        'startTimeoutMinutes': 123
    },
    'description': 'string',
    'domainId': 'string',
    'environmentActions': [
        {
            'auth': 'IAM'|'HTTPS',
            'parameters': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'type': 'string'
        },
    ],
    'environmentBlueprintId': 'string',
    'environmentProfileId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastDeployment': {
        'deploymentId': 'string',
        'deploymentStatus': 'IN_PROGRESS'|'SUCCESSFUL'|'FAILED'|'PENDING_DEPLOYMENT',
        'deploymentType': 'CREATE'|'UPDATE'|'DELETE',
        'failureReason': {
            'code': 'string',
            'message': 'string'
        },
        'isDeploymentComplete': True|False,
        'messages': [
            'string',
        ]
    },
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'provisionedResources': [
        {
            'name': 'string',
            'provider': 'string',
            'type': 'string',
            'value': 'string'
        },
    ],
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'|'VALIDATION_FAILED'|'SUSPENDED'|'DISABLED'|'EXPIRED'|'DELETED'|'INACCESSIBLE',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • awsAccountId (string) --

      The Amazon Web Services account in which the Amazon DataZone environment is created.

    • awsAccountRegion (string) --

      The Amazon Web Services region in which the Amazon DataZone environment is created.

    • createdAt (datetime) --

      The timestamp of when the environment was created.

    • createdBy (string) --

      The Amazon DataZone user who created this environment.

    • deploymentProperties (dict) --

      The deployment properties of this Amazon DataZone environment.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

    • description (string) --

      The description of this Amazon DataZone environment.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which the environment is created.

    • environmentActions (list) --

      The configurable actions of this Amazon DataZone environment.

      • (dict) --

        The configurable action of a Amazon DataZone environment.

        • auth (string) --

          The authentication type of a configurable action of a Amazon DataZone environment.

        • parameters (list) --

          The parameters of a configurable action in a Amazon DataZone environment.

          • (dict) --

            The details of the parameters for the configurable environment action.

            • key (string) --

              The key of the configurable action parameter.

            • value (string) --

              The value of the configurable action parameter.

        • type (string) --

          The type of a configurable action in a Amazon DataZone environment.

    • environmentBlueprintId (string) --

      The ID of the blueprint with which this Amazon DataZone environment was created.

    • environmentProfileId (string) --

      The ID of the environment profile with which this Amazon DataZone environment was created.

    • glossaryTerms (list) --

      The glossary terms that can be used in this Amazon DataZone environment.

      • (string) --

    • id (string) --

      The ID of this Amazon DataZone environment.

    • lastDeployment (dict) --

      The details of the last deployment of this Amazon DataZone environment.

      • deploymentId (string) --

        The identifier of the last deployment of the environment.

      • deploymentStatus (string) --

        The status of the last deployment of the environment.

      • deploymentType (string) --

        The type of the last deployment of the environment.

      • failureReason (dict) --

        The failure reason of the last deployment of the environment.

        • code (string) --

          The error code for the failure reason for the environment deployment.

        • message (string) --

          The error message for the failure reason for the environment deployment.

      • isDeploymentComplete (boolean) --

        Specifies whether the last deployment of the environment is complete.

      • messages (list) --

        The messages of the last deployment of the environment.

        • (string) --

    • name (string) --

      The name of this environment.

    • projectId (string) --

      The ID of the Amazon DataZone project in which this environment is created.

    • provider (string) --

      The provider of this Amazon DataZone environment.

    • provisionedResources (list) --

      The provisioned resources of this Amazon DataZone environment.

      • (dict) --

        The details of a provisioned resource of this Amazon DataZone environment.

        • name (string) --

          The name of a provisioned resource of this Amazon DataZone environment.

        • provider (string) --

          The provider of a provisioned resource of this Amazon DataZone environment.

        • type (string) --

          The type of a provisioned resource of this Amazon DataZone environment.

        • value (string) --

          The value of a provisioned resource of this Amazon DataZone environment.

    • provisioningProperties (dict) --

      The provisioning properties of this Amazon DataZone environment.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • status (string) --

      The status of this Amazon DataZone environment.

    • updatedAt (datetime) --

      The timestamp of when this environment was updated.

    • userParameters (list) --

      The user parameters of this Amazon DataZone environment.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

CreateEnvironmentProfile (new) Link ¶

Creates an Amazon DataZone environment profile.

See also: AWS API Documentation

Request Syntax

client.create_environment_profile(
    awsAccountId='string',
    awsAccountRegion='string',
    description='string',
    domainIdentifier='string',
    environmentBlueprintIdentifier='string',
    name='string',
    projectIdentifier='string',
    userParameters=[
        {
            'name': 'string',
            'value': 'string'
        },
    ]
)
type awsAccountId

string

param awsAccountId

The Amazon Web Services account in which the Amazon DataZone environment is created.

type awsAccountRegion

string

param awsAccountRegion

The Amazon Web Services region in which this environment profile is created.

type description

string

param description

The description of this Amazon DataZone environment profile.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this environment profile is created.

type environmentBlueprintIdentifier

string

param environmentBlueprintIdentifier

[REQUIRED]

The ID of the blueprint with which this environment profile is created.

type name

string

param name

[REQUIRED]

The name of this Amazon DataZone environment profile.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The identifier of the project in which to create the environment profile.

type userParameters

list

param userParameters

The user parameters of this Amazon DataZone environment profile.

  • (dict) --

    The parameter details of an evironment profile.

    • name (string) --

      The name of an environment profile parameter.

    • value (string) --

      The value of an environment profile parameter.

rtype

dict

returns

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'environmentBlueprintId': 'string',
    'id': 'string',
    'name': 'string',
    'projectId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • awsAccountId (string) --

      The Amazon Web Services account ID in which this Amazon DataZone environment profile is created.

    • awsAccountRegion (string) --

      The Amazon Web Services region in which this Amazon DataZone environment profile is created.

    • createdAt (datetime) --

      The timestamp of when this environment profile was created.

    • createdBy (string) --

      The Amazon DataZone user who created this environment profile.

    • description (string) --

      The description of this Amazon DataZone environment profile.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this environment profile is created.

    • environmentBlueprintId (string) --

      The ID of the blueprint with which this environment profile is created.

    • id (string) --

      The ID of this Amazon DataZone environment profile.

    • name (string) --

      The name of this Amazon DataZone environment profile.

    • projectId (string) --

      The ID of the Amazon DataZone project in which this environment profile is created.

    • updatedAt (datetime) --

      The timestamp of when this environment profile was updated.

    • userParameters (list) --

      The user parameters of this Amazon DataZone environment profile.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

ListSubscriptionGrants (new) Link ¶

Lists subscription grants.

See also: AWS API Documentation

Request Syntax

client.list_subscription_grants(
    domainIdentifier='string',
    environmentId='string',
    maxResults=123,
    nextToken='string',
    sortBy='CREATED_AT'|'UPDATED_AT',
    sortOrder='ASCENDING'|'DESCENDING',
    subscribedListingId='string',
    subscriptionId='string',
    subscriptionTargetId='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type environmentId

string

param environmentId

The identifier of the Amazon DataZone environment.

type maxResults

integer

param maxResults

The maximum number of subscription grants to return in a single call to ListSubscriptionGrants . When the number of subscription grants to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListSubscriptionGrants to list the next set of subscription grants.

type nextToken

string

param nextToken

When the number of subscription grants is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscription grants, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptionGrants to list the next set of subscription grants.

type sortBy

string

param sortBy

Specifies the way of sorting the results of this action.

type sortOrder

string

param sortOrder

Specifies the sort order of this action.

type subscribedListingId

string

param subscribedListingId

The identifier of the subscribed listing.

type subscriptionId

string

param subscriptionId

The identifier of the subscription.

type subscriptionTargetId

string

param subscriptionTargetId

The identifier of the subscription target.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'assets': [
                {
                    'assetId': 'string',
                    'assetRevision': 'string',
                    'failureCause': {
                        'message': 'string'
                    },
                    'failureTimestamp': datetime(2015, 1, 1),
                    'grantedTimestamp': datetime(2015, 1, 1),
                    'status': 'GRANT_PENDING'|'REVOKE_PENDING'|'GRANT_IN_PROGRESS'|'REVOKE_IN_PROGRESS'|'GRANTED'|'REVOKED'|'GRANT_FAILED'|'REVOKE_FAILED',
                    'targetName': 'string'
                },
            ],
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'domainId': 'string',
            'grantedEntity': {
                'listing': {
                    'id': 'string',
                    'revision': 'string'
                }
            },
            'id': 'string',
            'status': 'PENDING'|'IN_PROGRESS'|'GRANT_FAILED'|'REVOKE_FAILED'|'GRANT_AND_REVOKE_FAILED'|'COMPLETED'|'INACCESSIBLE',
            'subscriptionId': 'string',
            'subscriptionTargetId': 'string',
            'updatedAt': datetime(2015, 1, 1),
            'updatedBy': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListSubscriptionGrants action.

      • (dict) --

        The details of the subscription grant.

        • assets (list) --

          The assets included in the subscription grant.

          • (dict) --

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

            • assetId (string) --

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

            • assetRevision (string) --

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

            • failureCause (dict) --

              The failure cause included in the details of the asset for which the subscription grant is created.

              • message (string) --

                The description of the error message.

            • failureTimestamp (datetime) --

              The failure timestamp included in the details of the asset for which the subscription grant is created.

            • grantedTimestamp (datetime) --

              The timestamp of when the subscription grant to the asset is created.

            • status (string) --

              The status of the asset for which the subscription grant is created.

            • targetName (string) --

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

        • createdAt (datetime) --

          The timestamp of when a subscription grant was created.

        • createdBy (string) --

          The datazone user who created the subscription grant.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which a subscription grant exists.

        • grantedEntity (dict) --

          The entity to which the subscription is granted.

          • listing (dict) --

            The listing for which a subscription is granted.

            • id (string) --

              An identifier of a revision of an asset published in a Amazon DataZone catalog.

            • revision (string) --

              The details of a revision of an asset published in a Amazon DataZone catalog.

        • id (string) --

          The identifier of the subscription grant.

        • status (string) --

          The status of the subscription grant.

        • subscriptionId (string) --

          The ID of the subscription grant.

        • subscriptionTargetId (string) --

          The identifier of the target of the subscription grant.

        • updatedAt (datetime) --

          The timestampf of when the subscription grant was updated.

        • updatedBy (string) --

          The Amazon DataZone user who updated the subscription grant.

    • nextToken (string) --

      When the number of subscription grants is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscription grants, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptionGrants to list the next set of subscription grants.

ListDataSources (new) Link ¶

Lists data sources in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.list_data_sources(
    domainIdentifier='string',
    environmentIdentifier='string',
    maxResults=123,
    name='string',
    nextToken='string',
    projectIdentifier='string',
    status='CREATING'|'FAILED_CREATION'|'READY'|'UPDATING'|'FAILED_UPDATE'|'RUNNING'|'DELETING'|'FAILED_DELETION',
    type='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which to list the data sources.

type environmentIdentifier

string

param environmentIdentifier

The identifier of the environment in which to list the data sources.

type maxResults

integer

param maxResults

The maximum number of data sources to return in a single call to ListDataSources . When the number of data sources to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListDataSources to list the next set of data sources.

type name

string

param name

The name of the data source.

type nextToken

string

param nextToken

When the number of data sources is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of data sources, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDataSources to list the next set of data sources.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The identifier of the project in which to list data sources.

type status

string

param status

The status of the data source.

type type

string

param type

The type of the data source.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'dataSourceId': 'string',
            'domainId': 'string',
            'enableSetting': 'ENABLED'|'DISABLED',
            'environmentId': 'string',
            'lastRunAssetCount': 123,
            'lastRunAt': datetime(2015, 1, 1),
            'lastRunErrorMessage': {
                'errorDetail': 'string',
                'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
            },
            'lastRunStatus': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
            'name': 'string',
            'schedule': {
                'schedule': 'string',
                'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
            },
            'status': 'CREATING'|'FAILED_CREATION'|'READY'|'UPDATING'|'FAILED_UPDATE'|'RUNNING'|'DELETING'|'FAILED_DELETION',
            'type': 'string',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListDataSources action.

      • (dict) --

        The details of the data source.

        • createdAt (datetime) --

          The timestamp of when the data source was created.

        • dataSourceId (string) --

          The ID of the data source.

        • domainId (string) --

          The ID of the Amazon DataZone domain in which the data source exists.

        • enableSetting (string) --

          Specifies whether the data source is enabled.

        • environmentId (string) --

          The ID of the environment in which the data source exists.

        • lastRunAssetCount (integer) --

          The count of the assets created during the last data source run.

        • lastRunAt (datetime) --

          The timestamp of when the data source run was last performed.

        • lastRunErrorMessage (dict) --

          The details of the error message that is returned if the operation cannot be successfully completed.

          • errorDetail (string) --

            The details of the error message that is returned if the operation cannot be successfully completed.

          • errorType (string) --

            The type of the error message that is returned if the operation cannot be successfully completed.

        • lastRunStatus (string) --

          The status of the last data source run.

        • name (string) --

          The name of the data source.

        • schedule (dict) --

          The details of the schedule of the data source runs.

          • schedule (string) --

            The schedule of the data source runs.

          • timezone (string) --

            The timezone of the data source run.

        • status (string) --

          The status of the data source.

        • type (string) --

          The type of the data source.

        • updatedAt (datetime) --

          The timestamp of when the data source was updated.

    • nextToken (string) --

      When the number of data sources is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of data sources, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDataSources to list the next set of data sources.

CreateListingChangeSet (new) Link ¶

See also: AWS API Documentation

Request Syntax

client.create_listing_change_set(
    action='PUBLISH'|'UNPUBLISH',
    clientToken='string',
    domainIdentifier='string',
    entityIdentifier='string',
    entityRevision='string',
    entityType='ASSET'
)
type action

string

param action

[REQUIRED]

type clientToken

string

param clientToken

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

type entityIdentifier

string

param entityIdentifier

[REQUIRED]

type entityRevision

string

param entityRevision

type entityType

string

param entityType

[REQUIRED]

rtype

dict

returns

Response Syntax

{
    'listingId': 'string',
    'listingRevision': 'string',
    'status': 'CREATING'|'ACTIVE'|'INACTIVE'
}

Response Structure

  • (dict) --

    • listingId (string) --

    • listingRevision (string) --

    • status (string) --

GetGroupProfile (new) Link ¶

Gets a group profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_group_profile(
    domainIdentifier='string',
    groupIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which the group profile exists.

type groupIdentifier

string

param groupIdentifier

[REQUIRED]

The identifier of the group profile.

rtype

dict

returns

Response Syntax

{
    'domainId': 'string',
    'groupName': 'string',
    'id': 'string',
    'status': 'ASSIGNED'|'NOT_ASSIGNED'
}

Response Structure

  • (dict) --

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which the group profile exists.

    • groupName (string) --

      The name of the group for which the specified group profile exists.

    • id (string) --

      The identifier of the group profile.

    • status (string) --

      The identifier of the group profile.

GetUserProfile (new) Link ¶

Gets a user profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_user_profile(
    domainIdentifier='string',
    type='IAM'|'SSO',
    userIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

the ID of the Amazon DataZone domain the data portal of which you want to get.

type type

string

param type

The type of the user profile.

type userIdentifier

string

param userIdentifier

[REQUIRED]

The identifier of the user for which you want to get the user profile.

rtype

dict

returns

Response Syntax

{
    'details': {
        'iam': {
            'arn': 'string'
        },
        'sso': {
            'firstName': 'string',
            'lastName': 'string',
            'username': 'string'
        }
    },
    'domainId': 'string',
    'id': 'string',
    'status': 'ASSIGNED'|'NOT_ASSIGNED'|'ACTIVATED'|'DEACTIVATED',
    'type': 'IAM'|'SSO'
}

Response Structure

  • (dict) --

    • details (dict) --

      The details of the user profile in Amazon DataZone.

      • iam (dict) --

        The IAM details included in the user profile details.

        • arn (string) --

          The ARN of an IAM user profile in Amazon DataZone.

      • sso (dict) --

        The single sign-on details included in the user profile details.

        • firstName (string) --

          The first name included in the single sign-on details of the user profile.

        • lastName (string) --

          The last name included in the single sign-on details of the user profile.

        • username (string) --

          The username included in the single sign-on details of the user profile.

    • domainId (string) --

      the identifier of the Amazon DataZone domain of which you want to get the user profile.

    • id (string) --

      The identifier of the user profile.

    • status (string) --

      The status of the user profile.

    • type (string) --

      The type of the user profile.

PutEnvironmentBlueprintConfiguration (new) Link ¶

Writes the configuration for the specified environment blueprint in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.put_environment_blueprint_configuration(
    domainIdentifier='string',
    enabledRegions=[
        'string',
    ],
    environmentBlueprintIdentifier='string',
    manageAccessRoleArn='string',
    provisioningRoleArn='string',
    regionalParameters={
        'string': {
            'string': 'string'
        }
    }
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type enabledRegions

list

param enabledRegions

[REQUIRED]

Specifies the enabled Amazon Web Services Regions.

  • (string) --

type environmentBlueprintIdentifier

string

param environmentBlueprintIdentifier

[REQUIRED]

The identifier of the environment blueprint.

type manageAccessRoleArn

string

param manageAccessRoleArn

The ARN of the manage access role.

type provisioningRoleArn

string

param provisioningRoleArn

The ARN of the provisioning role.

type regionalParameters

dict

param regionalParameters

The regional parameters in the environment blueprint.

  • (string) --

    • (dict) --

      • (string) --

        • (string) --

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'domainId': 'string',
    'enabledRegions': [
        'string',
    ],
    'environmentBlueprintId': 'string',
    'manageAccessRoleArn': 'string',
    'provisioningRoleArn': 'string',
    'regionalParameters': {
        'string': {
            'string': 'string'
        }
    },
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the environment blueprint was created.

    • domainId (string) --

      The identifier of the Amazon DataZone domain.

    • enabledRegions (list) --

      Specifies the enabled Amazon Web Services Regions.

      • (string) --

    • environmentBlueprintId (string) --

      The identifier of the environment blueprint.

    • manageAccessRoleArn (string) --

      The ARN of the manage access role.

    • provisioningRoleArn (string) --

      The ARN of the provisioning role.

    • regionalParameters (dict) --

      The regional parameters in the environment blueprint.

      • (string) --

        • (dict) --

          • (string) --

            • (string) --

    • updatedAt (datetime) --

      The timestamp of when the environment blueprint was updated.

UpdateDataSource (new) Link ¶

Updates the specified data source in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_data_source(
    assetFormsInput=[
        {
            'content': 'string',
            'formName': 'string',
            'typeIdentifier': 'string',
            'typeRevision': 'string'
        },
    ],
    configuration={
        'glueRunConfiguration': {
            'dataAccessRole': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        },
        'redshiftRunConfiguration': {
            'dataAccessRole': 'string',
            'redshiftCredentialConfiguration': {
                'secretManagerArn': 'string'
            },
            'redshiftStorage': {
                'redshiftClusterSource': {
                    'clusterName': 'string'
                },
                'redshiftServerlessSource': {
                    'workgroupName': 'string'
                }
            },
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        }
    },
    description='string',
    domainIdentifier='string',
    enableSetting='ENABLED'|'DISABLED',
    identifier='string',
    name='string',
    publishOnImport=True|False,
    recommendation={
        'enableBusinessNameGeneration': True|False
    },
    schedule={
        'schedule': 'string',
        'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
    }
)
type assetFormsInput

list

param assetFormsInput

The asset forms to be updated as part of the UpdateDataSource action.

  • (dict) --

    The details of a metadata form.

    • content (string) --

      The content of the metadata form.

    • formName (string) -- [REQUIRED]

      The name of the metadata form.

    • typeIdentifier (string) --

      The ID of the metadata form type.

    • typeRevision (string) --

      The revision of the metadata form type.

type configuration

dict

param configuration

The configuration to be updated as part of the UpdateDataSource action.

  • glueRunConfiguration (dict) --

    The configuration of the Amazon Web Services Glue data source.

    • dataAccessRole (string) --

      The data access role included in the configuration details of the Amazon Web Services Glue data source.

    • relationalFilterConfigurations (list) -- [REQUIRED]

      The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.

      • (dict) --

        The relational filter configuration for the data source.

        • databaseName (string) -- [REQUIRED]

          The database name specified in the relational filter configuration for the data source.

        • filterExpressions (list) --

          The filter expressions specified in the relational filter configuration for the data source.

          • (dict) --

            A filter expression in Amazon DataZone.

            • expression (string) -- [REQUIRED]

              The search filter expression.

            • type (string) -- [REQUIRED]

              The search filter explresison type.

        • schemaName (string) --

          The schema name specified in the relational filter configuration for the data source.

  • redshiftRunConfiguration (dict) --

    The configuration of the Amazon Redshift data source.

    • dataAccessRole (string) --

      The data access role included in the configuration details of the Amazon Redshift data source.

    • redshiftCredentialConfiguration (dict) -- [REQUIRED]

      The details of the credentials required to access an Amazon Redshift cluster.

      • secretManagerArn (string) -- [REQUIRED]

        The ARN of a secret manager for an Amazon Redshift cluster.

    • redshiftStorage (dict) -- [REQUIRED]

      The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.

      • redshiftClusterSource (dict) --

        The details of the Amazon Redshift cluster source.

        • clusterName (string) -- [REQUIRED]

          The name of an Amazon Redshift cluster.

      • redshiftServerlessSource (dict) --

        The details of the Amazon Redshift Serverless workgroup source.

        • workgroupName (string) -- [REQUIRED]

          The name of the Amazon Redshift Serverless workgroup.

    • relationalFilterConfigurations (list) -- [REQUIRED]

      The relational filger configurations included in the configuration details of the Amazon Redshift data source.

      • (dict) --

        The relational filter configuration for the data source.

        • databaseName (string) -- [REQUIRED]

          The database name specified in the relational filter configuration for the data source.

        • filterExpressions (list) --

          The filter expressions specified in the relational filter configuration for the data source.

          • (dict) --

            A filter expression in Amazon DataZone.

            • expression (string) -- [REQUIRED]

              The search filter expression.

            • type (string) -- [REQUIRED]

              The search filter explresison type.

        • schemaName (string) --

          The schema name specified in the relational filter configuration for the data source.

type description

string

param description

The description to be updated as part of the UpdateDataSource action.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the domain in which to update a data source.

type enableSetting

string

param enableSetting

The enable setting to be updated as part of the UpdateDataSource action.

type identifier

string

param identifier

[REQUIRED]

The identifier of the data source to be updated.

type name

string

param name

The name to be updated as part of the UpdateDataSource action.

type publishOnImport

boolean

param publishOnImport

The publish on import setting to be updated as part of the UpdateDataSource action.

type recommendation

dict

param recommendation

The recommendation to be updated as part of the UpdateDataSource action.

  • enableBusinessNameGeneration (boolean) --

    Specifies whether automatic business name generation is to be enabled or not as part of the recommendation configuration.

type schedule

dict

param schedule

The schedule to be updated as part of the UpdateDataSource action.

  • schedule (string) --

    The schedule of the data source runs.

  • timezone (string) --

    The timezone of the data source run.

rtype

dict

returns

Response Syntax

{
    'assetFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'configuration': {
        'glueRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        },
        'redshiftRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'redshiftCredentialConfiguration': {
                'secretManagerArn': 'string'
            },
            'redshiftStorage': {
                'redshiftClusterSource': {
                    'clusterName': 'string'
                },
                'redshiftServerlessSource': {
                    'workgroupName': 'string'
                }
            },
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        }
    },
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'domainId': 'string',
    'enableSetting': 'ENABLED'|'DISABLED',
    'environmentId': 'string',
    'errorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'id': 'string',
    'lastRunAt': datetime(2015, 1, 1),
    'lastRunErrorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'lastRunStatus': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
    'name': 'string',
    'projectId': 'string',
    'publishOnImport': True|False,
    'recommendation': {
        'enableBusinessNameGeneration': True|False
    },
    'schedule': {
        'schedule': 'string',
        'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
    },
    'status': 'CREATING'|'FAILED_CREATION'|'READY'|'UPDATING'|'FAILED_UPDATE'|'RUNNING'|'DELETING'|'FAILED_DELETION',
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • assetFormsOutput (list) --

      The asset forms to be updated as part of the UpdateDataSource action.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • configuration (dict) --

      The configuration to be updated as part of the UpdateDataSource action.

      • glueRunConfiguration (dict) --

        The configuration of the Amazon Web Services Glue data source.

        • accountId (string) --

          The Amazon Web Services account ID included in the configuration details of the Amazon Web Services Glue data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Web Services Glue data source.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Web Services Glue data source.

        • relationalFilterConfigurations (list) --

          The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

      • redshiftRunConfiguration (dict) --

        The configuration of the Amazon Redshift data source.

        • accountId (string) --

          The ID of the Amazon Web Services account included in the configuration details of the Amazon Redshift data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Redshift data source.

        • redshiftCredentialConfiguration (dict) --

          The details of the credentials required to access an Amazon Redshift cluster.

          • secretManagerArn (string) --

            The ARN of a secret manager for an Amazon Redshift cluster.

        • redshiftStorage (dict) --

          The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.

          • redshiftClusterSource (dict) --

            The details of the Amazon Redshift cluster source.

            • clusterName (string) --

              The name of an Amazon Redshift cluster.

          • redshiftServerlessSource (dict) --

            The details of the Amazon Redshift Serverless workgroup source.

            • workgroupName (string) --

              The name of the Amazon Redshift Serverless workgroup.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Redshift data source.

        • relationalFilterConfigurations (list) --

          The relational filger configurations included in the configuration details of the Amazon Redshift data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

    • createdAt (datetime) --

      The timestamp of when the data source was updated.

    • description (string) --

      The description to be updated as part of the UpdateDataSource action.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a data source is to be updated.

    • enableSetting (string) --

      The enable setting to be updated as part of the UpdateDataSource action.

    • environmentId (string) --

      The identifier of the environment in which a data source is to be updated.

    • errorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • id (string) --

      The identifier of the data source to be updated.

    • lastRunAt (datetime) --

      The timestamp of when the data source was last run.

    • lastRunErrorMessage (dict) --

      The last run error message of the data source.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • lastRunStatus (string) --

      The last run status of the data source.

    • name (string) --

      The name to be updated as part of the UpdateDataSource action.

    • projectId (string) --

      The identifier of the project where data source is to be updated.

    • publishOnImport (boolean) --

      The publish on import setting to be updated as part of the UpdateDataSource action.

    • recommendation (dict) --

      The recommendation to be updated as part of the UpdateDataSource action.

      • enableBusinessNameGeneration (boolean) --

        Specifies whether automatic business name generation is to be enabled or not as part of the recommendation configuration.

    • schedule (dict) --

      The schedule to be updated as part of the UpdateDataSource action.

      • schedule (string) --

        The schedule of the data source runs.

      • timezone (string) --

        The timezone of the data source run.

    • status (string) --

      The status to be updated as part of the UpdateDataSource action.

    • type (string) --

      The type to be updated as part of the UpdateDataSource action.

    • updatedAt (datetime) --

      The timestamp of when the data source was updated.

GetEnvironment (new) Link ¶

Gets an Amazon DataZone environment.

See also: AWS API Documentation

Request Syntax

client.get_environment(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain where the environment exists.

type identifier

string

param identifier

[REQUIRED]

The ID of the Amazon DataZone environment.

rtype

dict

returns

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'deploymentProperties': {
        'endTimeoutMinutes': 123,
        'startTimeoutMinutes': 123
    },
    'description': 'string',
    'domainId': 'string',
    'environmentActions': [
        {
            'auth': 'IAM'|'HTTPS',
            'parameters': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'type': 'string'
        },
    ],
    'environmentBlueprintId': 'string',
    'environmentProfileId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastDeployment': {
        'deploymentId': 'string',
        'deploymentStatus': 'IN_PROGRESS'|'SUCCESSFUL'|'FAILED'|'PENDING_DEPLOYMENT',
        'deploymentType': 'CREATE'|'UPDATE'|'DELETE',
        'failureReason': {
            'code': 'string',
            'message': 'string'
        },
        'isDeploymentComplete': True|False,
        'messages': [
            'string',
        ]
    },
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'provisionedResources': [
        {
            'name': 'string',
            'provider': 'string',
            'type': 'string',
            'value': 'string'
        },
    ],
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'|'VALIDATION_FAILED'|'SUSPENDED'|'DISABLED'|'EXPIRED'|'DELETED'|'INACCESSIBLE',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • awsAccountId (string) --

      The ID of the Amazon Web Services account where the environment exists.

    • awsAccountRegion (string) --

      The Amazon Web Services region where the environment exists.

    • createdAt (datetime) --

      The timestamp of when the environment was created.

    • createdBy (string) --

      The Amazon DataZone user who created the environment.

    • deploymentProperties (dict) --

      The deployment properties of the environment.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

    • description (string) --

      The description of the environment.

    • domainId (string) --

      The ID of the Amazon DataZone domain where the environment exists.

    • environmentActions (list) --

      The actions of the environment.

      • (dict) --

        The configurable action of a Amazon DataZone environment.

        • auth (string) --

          The authentication type of a configurable action of a Amazon DataZone environment.

        • parameters (list) --

          The parameters of a configurable action in a Amazon DataZone environment.

          • (dict) --

            The details of the parameters for the configurable environment action.

            • key (string) --

              The key of the configurable action parameter.

            • value (string) --

              The value of the configurable action parameter.

        • type (string) --

          The type of a configurable action in a Amazon DataZone environment.

    • environmentBlueprintId (string) --

      The blueprint with which the environment is created.

    • environmentProfileId (string) --

      The ID of the environment profile with which the environment is created.

    • glossaryTerms (list) --

      The business glossary terms that can be used in this environment.

      • (string) --

    • id (string) --

      The ID of the environment.

    • lastDeployment (dict) --

      The details of the last deployment of the environment.

      • deploymentId (string) --

        The identifier of the last deployment of the environment.

      • deploymentStatus (string) --

        The status of the last deployment of the environment.

      • deploymentType (string) --

        The type of the last deployment of the environment.

      • failureReason (dict) --

        The failure reason of the last deployment of the environment.

        • code (string) --

          The error code for the failure reason for the environment deployment.

        • message (string) --

          The error message for the failure reason for the environment deployment.

      • isDeploymentComplete (boolean) --

        Specifies whether the last deployment of the environment is complete.

      • messages (list) --

        The messages of the last deployment of the environment.

        • (string) --

    • name (string) --

      The name of the environment.

    • projectId (string) --

      The ID of the Amazon DataZone project in which this environment is created.

    • provider (string) --

      The provider of this Amazon DataZone environment.

    • provisionedResources (list) --

      The provisioned resources of this Amazon DataZone environment.

      • (dict) --

        The details of a provisioned resource of this Amazon DataZone environment.

        • name (string) --

          The name of a provisioned resource of this Amazon DataZone environment.

        • provider (string) --

          The provider of a provisioned resource of this Amazon DataZone environment.

        • type (string) --

          The type of a provisioned resource of this Amazon DataZone environment.

        • value (string) --

          The value of a provisioned resource of this Amazon DataZone environment.

    • provisioningProperties (dict) --

      The provisioning properties of this Amazon DataZone environment.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • status (string) --

      The status of this Amazon DataZone environment.

    • updatedAt (datetime) --

      The timestamp of when this environment was updated.

    • userParameters (list) --

      The user parameters of this Amazon DataZone environment.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

GetListing (new) Link ¶

See also: AWS API Documentation

Request Syntax

client.get_listing(
    domainIdentifier='string',
    identifier='string',
    listingRevision='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

type identifier

string

param identifier

[REQUIRED]

type listingRevision

string

param listingRevision

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'id': 'string',
    'item': {
        'assetListing': {
            'assetId': 'string',
            'assetRevision': 'string',
            'assetType': 'string',
            'createdAt': datetime(2015, 1, 1),
            'forms': 'string',
            'glossaryTerms': [
                {
                    'name': 'string',
                    'shortDescription': 'string'
                },
            ],
            'owningProjectId': 'string'
        }
    },
    'listingRevision': 'string',
    'name': 'string',
    'status': 'CREATING'|'ACTIVE'|'INACTIVE',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

    • createdBy (string) --

      The Amazon DataZone user who created the listing.

    • description (string) --

    • domainId (string) --

    • id (string) --

    • item (dict) --

      • assetListing (dict) --

        An asset published in an Amazon DataZone catalog.

        • assetId (string) --

          The identifier of an asset published in an Amazon DataZone catalog.

        • assetRevision (string) --

          The revision of an asset published in an Amazon DataZone catalog.

        • assetType (string) --

          The type of an asset published in an Amazon DataZone catalog.

        • createdAt (datetime) --

          The timestamp of when an asset published in an Amazon DataZone catalog was created.

        • forms (string) --

          The metadata forms attached to an asset published in an Amazon DataZone catalog.

        • glossaryTerms (list) --

          The glossary terms attached to an asset published in an Amazon DataZone catalog.

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

        • owningProjectId (string) --

          The identifier of the project where an asset published in an Amazon DataZone catalog exists.

    • listingRevision (string) --

    • name (string) --

    • status (string) --

    • updatedAt (datetime) --

      The timestamp of when the listing was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the listing.

ListEnvironmentBlueprintConfigurations (new) Link ¶

Lists blueprint configurations for a Amazon DataZone environment.

See also: AWS API Documentation

Request Syntax

client.list_environment_blueprint_configurations(
    domainIdentifier='string',
    maxResults=123,
    nextToken='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type maxResults

integer

param maxResults

The maximum number of blueprint configurations to return in a single call to ListEnvironmentBlueprintConfigurations . When the number of configurations to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListEnvironmentBlueprintConfigurations to list the next set of configurations.

type nextToken

string

param nextToken

When the number of blueprint configurations is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of configurations, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironmentBlueprintConfigurations to list the next set of configurations.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'domainId': 'string',
            'enabledRegions': [
                'string',
            ],
            'environmentBlueprintId': 'string',
            'manageAccessRoleArn': 'string',
            'provisioningRoleArn': 'string',
            'regionalParameters': {
                'string': {
                    'string': 'string'
                }
            },
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListEnvironmentBlueprintConfigurations action.

      • (dict) --

        The configuration details of an environment blueprint.

        • createdAt (datetime) --

          The timestamp of when an environment blueprint was created.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which an environment blueprint exists.

        • enabledRegions (list) --

          The enabled Amazon Web Services Regions specified in a blueprint configuration.

          • (string) --

        • environmentBlueprintId (string) --

          The identifier of the environment blueprint.

        • manageAccessRoleArn (string) --

          The ARN of the manage access role specified in the environment blueprint configuration.

        • provisioningRoleArn (string) --

          The ARN of the provisioning role specified in the environment blueprint configuration.

        • regionalParameters (dict) --

          The regional parameters of the environment blueprint.

          • (string) --

            • (dict) --

              • (string) --

                • (string) --

        • updatedAt (datetime) --

          The timestamp of when the environment blueprint was updated.

    • nextToken (string) --

      When the number of blueprint configurations is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of configurations, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironmentBlueprintConfigurations to list the next set of configurations.

GetEnvironmentBlueprint (new) Link ¶

Gets an Amazon DataZone blueprint.

See also: AWS API Documentation

Request Syntax

client.get_environment_blueprint(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the domain in which this blueprint exists.

type identifier

string

param identifier

[REQUIRED]

The ID of this Amazon DataZone blueprint.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'deploymentProperties': {
        'endTimeoutMinutes': 123,
        'startTimeoutMinutes': 123
    },
    'description': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'name': 'string',
    'provider': 'string',
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      A timestamp of when this blueprint was created.

    • deploymentProperties (dict) --

      The deployment properties of this Amazon DataZone blueprint.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

    • description (string) --

      The description of this Amazon DataZone blueprint.

    • glossaryTerms (list) --

      The glossary terms attached to this Amazon DataZone blueprint.

      • (string) --

    • id (string) --

      The ID of this Amazon DataZone blueprint.

    • name (string) --

      The name of this Amazon DataZone blueprint.

    • provider (string) --

      The provider of this Amazon DataZone blueprint.

    • provisioningProperties (dict) --

      The provisioning properties of this Amazon DataZone blueprint.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • updatedAt (datetime) --

      The timestamp of when this blueprint was updated.

    • userParameters (list) --

      The user parameters of this blueprint.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

DeleteGlossaryTerm (new) Link ¶

Deletes a business glossary term in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_glossary_term(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the business glossary term is deleted.

type identifier

string

param identifier

[REQUIRED]

The ID of the business glossary term that is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

UpdateSubscriptionTarget (new) Link ¶

Updates the specified subscription target in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_subscription_target(
    applicableAssetTypes=[
        'string',
    ],
    authorizedPrincipals=[
        'string',
    ],
    domainIdentifier='string',
    environmentIdentifier='string',
    identifier='string',
    manageAccessRole='string',
    name='string',
    provider='string',
    subscriptionTargetConfig=[
        {
            'content': 'string',
            'formName': 'string'
        },
    ]
)
type applicableAssetTypes

list

param applicableAssetTypes

The applicable asset types to be updated as part of the UpdateSubscriptionTarget action.

  • (string) --

type authorizedPrincipals

list

param authorizedPrincipals

The authorized principals to be updated as part of the UpdateSubscriptionTarget action.

  • (string) --

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a subscription target is to be updated.

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The identifier of the environment in which a subscription target is to be updated.

type identifier

string

param identifier

[REQUIRED]

Identifier of the subscription target that is to be updated.

type manageAccessRole

string

param manageAccessRole

The manage access role to be updated as part of the UpdateSubscriptionTarget action.

type name

string

param name

The name to be updated as part of the UpdateSubscriptionTarget action.

type provider

string

param provider

The provider to be updated as part of the UpdateSubscriptionTarget action.

type subscriptionTargetConfig

list

param subscriptionTargetConfig

The configuration to be updated as part of the UpdateSubscriptionTarget action.

  • (dict) --

    The details of the subscription target configuration.

    • content (string) -- [REQUIRED]

      The content of the subscription target configuration.

    • formName (string) -- [REQUIRED]

      The form name included in the subscription target configuration.

rtype

dict

returns

Response Syntax

{
    'applicableAssetTypes': [
        'string',
    ],
    'authorizedPrincipals': [
        'string',
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'environmentId': 'string',
    'id': 'string',
    'manageAccessRole': 'string',
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'subscriptionTargetConfig': [
        {
            'content': 'string',
            'formName': 'string'
        },
    ],
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • applicableAssetTypes (list) --

      The applicable asset types to be updated as part of the UpdateSubscriptionTarget action.

      • (string) --

    • authorizedPrincipals (list) --

      The authorized principals to be updated as part of the UpdateSubscriptionTarget action.

      • (string) --

    • createdAt (datetime) --

      The timestamp of when a subscription target was created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription target.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a subscription target is to be updated.

    • environmentId (string) --

      The identifier of the environment in which a subscription target is to be updated.

    • id (string) --

      Identifier of the subscription target that is to be updated.

    • manageAccessRole (string) --

      The manage access role to be updated as part of the UpdateSubscriptionTarget action.

    • name (string) --

      The name to be updated as part of the UpdateSubscriptionTarget action.

    • projectId (string) --

      The identifier of the project in which a subscription target is to be updated.

    • provider (string) --

      The provider to be updated as part of the UpdateSubscriptionTarget action.

    • subscriptionTargetConfig (list) --

      The configuration to be updated as part of the UpdateSubscriptionTarget action.

      • (dict) --

        The details of the subscription target configuration.

        • content (string) --

          The content of the subscription target configuration.

        • formName (string) --

          The form name included in the subscription target configuration.

    • type (string) --

      The type to be updated as part of the UpdateSubscriptionTarget action.

    • updatedAt (datetime) --

      The timestamp of when the subscription target was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription target.

UpdateEnvironment (new) Link ¶

Updates the specified environment in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_environment(
    description='string',
    domainIdentifier='string',
    glossaryTerms=[
        'string',
    ],
    identifier='string',
    name='string'
)
type description

string

param description

The description to be updated as part of the UpdateEnvironment action.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the domain in which the environment is to be updated.

type glossaryTerms

list

param glossaryTerms

The glossary terms to be updated as part of the UpdateEnvironment action.

  • (string) --

type identifier

string

param identifier

[REQUIRED]

The identifier of the environment that is to be updated.

type name

string

param name

The name to be updated as part of the UpdateEnvironment action.

rtype

dict

returns

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'deploymentProperties': {
        'endTimeoutMinutes': 123,
        'startTimeoutMinutes': 123
    },
    'description': 'string',
    'domainId': 'string',
    'environmentActions': [
        {
            'auth': 'IAM'|'HTTPS',
            'parameters': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'type': 'string'
        },
    ],
    'environmentBlueprintId': 'string',
    'environmentProfileId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastDeployment': {
        'deploymentId': 'string',
        'deploymentStatus': 'IN_PROGRESS'|'SUCCESSFUL'|'FAILED'|'PENDING_DEPLOYMENT',
        'deploymentType': 'CREATE'|'UPDATE'|'DELETE',
        'failureReason': {
            'code': 'string',
            'message': 'string'
        },
        'isDeploymentComplete': True|False,
        'messages': [
            'string',
        ]
    },
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'provisionedResources': [
        {
            'name': 'string',
            'provider': 'string',
            'type': 'string',
            'value': 'string'
        },
    ],
    'provisioningProperties': {
        'cloudFormation': {
            'templateUrl': 'string'
        }
    },
    'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'|'VALIDATION_FAILED'|'SUSPENDED'|'DISABLED'|'EXPIRED'|'DELETED'|'INACCESSIBLE',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • awsAccountId (string) --

      The identifier of the Amazon Web Services account in which the environment is to be updated.

    • awsAccountRegion (string) --

      The Amazon Web Services Region in which the environment is updated.

    • createdAt (datetime) --

      The timestamp of when the environment was created.

    • createdBy (string) --

      The Amazon DataZone user who created the environment.

    • deploymentProperties (dict) --

      The deployment properties to be updated as part of the UpdateEnvironment action.

      • endTimeoutMinutes (integer) --

        The end timeout of the environment blueprint deployment.

      • startTimeoutMinutes (integer) --

        The start timeout of the environment blueprint deployment.

    • description (string) --

      The description to be updated as part of the UpdateEnvironment action.

    • domainId (string) --

      The identifier of the domain in which the environment is to be updated.

    • environmentActions (list) --

      The environment actions to be updated as part of the UpdateEnvironment action.

      • (dict) --

        The configurable action of a Amazon DataZone environment.

        • auth (string) --

          The authentication type of a configurable action of a Amazon DataZone environment.

        • parameters (list) --

          The parameters of a configurable action in a Amazon DataZone environment.

          • (dict) --

            The details of the parameters for the configurable environment action.

            • key (string) --

              The key of the configurable action parameter.

            • value (string) --

              The value of the configurable action parameter.

        • type (string) --

          The type of a configurable action in a Amazon DataZone environment.

    • environmentBlueprintId (string) --

      The blueprint identifier of the environment.

    • environmentProfileId (string) --

      The profile identifier of the environment.

    • glossaryTerms (list) --

      The glossary terms to be updated as part of the UpdateEnvironment action.

      • (string) --

    • id (string) --

      The identifier of the environment that is to be updated.

    • lastDeployment (dict) --

      The last deployment of the environment.

      • deploymentId (string) --

        The identifier of the last deployment of the environment.

      • deploymentStatus (string) --

        The status of the last deployment of the environment.

      • deploymentType (string) --

        The type of the last deployment of the environment.

      • failureReason (dict) --

        The failure reason of the last deployment of the environment.

        • code (string) --

          The error code for the failure reason for the environment deployment.

        • message (string) --

          The error message for the failure reason for the environment deployment.

      • isDeploymentComplete (boolean) --

        Specifies whether the last deployment of the environment is complete.

      • messages (list) --

        The messages of the last deployment of the environment.

        • (string) --

    • name (string) --

      The name to be updated as part of the UpdateEnvironment action.

    • projectId (string) --

      The project identifier of the environment.

    • provider (string) --

      The provider identifier of the environment.

    • provisionedResources (list) --

      The provisioned resources to be updated as part of the UpdateEnvironment action.

      • (dict) --

        The details of a provisioned resource of this Amazon DataZone environment.

        • name (string) --

          The name of a provisioned resource of this Amazon DataZone environment.

        • provider (string) --

          The provider of a provisioned resource of this Amazon DataZone environment.

        • type (string) --

          The type of a provisioned resource of this Amazon DataZone environment.

        • value (string) --

          The value of a provisioned resource of this Amazon DataZone environment.

    • provisioningProperties (dict) --

      The provisioning properties to be updated as part of the UpdateEnvironment action.

      • cloudFormation (dict) --

        The cloud formation properties included as part of the provisioning properties of an environment blueprint.

        • templateUrl (string) --

          The template URL of the cloud formation provisioning properties of the environment blueprint.

    • status (string) --

      The status to be updated as part of the UpdateEnvironment action.

    • updatedAt (datetime) --

      The timestamp of when the environment was updated.

    • userParameters (list) --

      The user parameters to be updated as part of the UpdateEnvironment action.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

ListNotifications (new) Link ¶

Lists all Amazon DataZone notifications.

See also: AWS API Documentation

Request Syntax

client.list_notifications(
    afterTimestamp=datetime(2015, 1, 1),
    beforeTimestamp=datetime(2015, 1, 1),
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    subjects=[
        'string',
    ],
    taskStatus='ACTIVE'|'INACTIVE',
    type='TASK'|'EVENT'
)
type afterTimestamp

datetime

param afterTimestamp

The time after which you want to list notifications.

type beforeTimestamp

datetime

param beforeTimestamp

The time before which you want to list notifications.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type maxResults

integer

param maxResults

The maximum number of notifications to return in a single call to ListNotifications . When the number of notifications to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListNotifications to list the next set of notifications.

type nextToken

string

param nextToken

When the number of notifications is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of notifications, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListNotifications to list the next set of notifications.

type subjects

list

param subjects

The subjects of notifications.

  • (string) --

type taskStatus

string

param taskStatus

The task status of notifications.

type type

string

param type

[REQUIRED]

The type of notifications.

rtype

dict

returns

Response Syntax

{
    'nextToken': 'string',
    'notifications': [
        {
            'actionLink': 'string',
            'creationTimestamp': datetime(2015, 1, 1),
            'domainIdentifier': 'string',
            'identifier': 'string',
            'lastUpdatedTimestamp': datetime(2015, 1, 1),
            'message': 'string',
            'metadata': {
                'string': 'string'
            },
            'status': 'ACTIVE'|'INACTIVE',
            'title': 'string',
            'topic': {
                'resource': {
                    'id': 'string',
                    'name': 'string',
                    'type': 'PROJECT'
                },
                'role': 'PROJECT_OWNER'|'PROJECT_CONTRIBUTOR'|'PROJECT_VIEWER'|'DOMAIN_OWNER'|'PROJECT_SUBSCRIBER',
                'subject': 'string'
            },
            'type': 'TASK'|'EVENT'
        },
    ]
}

Response Structure

  • (dict) --

    • nextToken (string) --

      When the number of notifications is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of notifications, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListNotifications to list the next set of notifications.

    • notifications (list) --

      The results of the ListNotifications action.

      • (dict) --

        The details of a notification generated in Amazon DataZone.

        • actionLink (string) --

          The action link included in the notification.

        • creationTimestamp (datetime) --

          The timestamp of when a notification was created.

        • domainIdentifier (string) --

          The identifier of a Amazon DataZone domain in which the notification exists.

        • identifier (string) --

          The identifier of the notification.

        • lastUpdatedTimestamp (datetime) --

          The timestamp of when the notification was last updated.

        • message (string) --

          The message included in the notification.

        • metadata (dict) --

          The metadata included in the notification.

          • (string) --

            • (string) --

        • status (string) --

          The status included in the notification.

        • title (string) --

          The title of the notification.

        • topic (dict) --

          The topic of the notification.

          • resource (dict) --

            The details of the resource mentioned in a notification.

            • id (string) --

              The ID of the resource mentioned in a notification.

            • name (string) --

              The name of the resource mentioned in a notification.

            • type (string) --

              The type of the resource mentioned in a notification.

          • role (string) --

            The role of the resource mentioned in a notification.

          • subject (string) --

            The subject of the resource mentioned in a notification.

        • type (string) --

          The type of the notification.

UpdateEnvironmentProfile (new) Link ¶

Updates the specified environment profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_environment_profile(
    awsAccountId='string',
    awsAccountRegion='string',
    description='string',
    domainIdentifier='string',
    identifier='string',
    name='string',
    userParameters=[
        {
            'name': 'string',
            'value': 'string'
        },
    ]
)
type awsAccountId

string

param awsAccountId

The Amazon Web Services account in which a specified environment profile is to be udpated.

type awsAccountRegion

string

param awsAccountRegion

The Amazon Web Services Region in which a specified environment profile is to be updated.

type description

string

param description

The description to be updated as part of the UpdateEnvironmentProfile action.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which an environment profile is to be updated.

type identifier

string

param identifier

[REQUIRED]

The identifier of the environment profile that is to be updated.

type name

string

param name

The name to be updated as part of the UpdateEnvironmentProfile action.

type userParameters

list

param userParameters

The user parameters to be updated as part of the UpdateEnvironmentProfile action.

  • (dict) --

    The parameter details of an evironment profile.

    • name (string) --

      The name of an environment profile parameter.

    • value (string) --

      The value of an environment profile parameter.

rtype

dict

returns

Response Syntax

{
    'awsAccountId': 'string',
    'awsAccountRegion': 'string',
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'environmentBlueprintId': 'string',
    'id': 'string',
    'name': 'string',
    'projectId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'userParameters': [
        {
            'defaultValue': 'string',
            'description': 'string',
            'fieldType': 'string',
            'isEditable': True|False,
            'isOptional': True|False,
            'keyName': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • awsAccountId (string) --

      The Amazon Web Services account in which a specified environment profile is to be udpated.

    • awsAccountRegion (string) --

      The Amazon Web Services Region in which a specified environment profile is to be updated.

    • createdAt (datetime) --

      The timestamp of when the environment profile was created.

    • createdBy (string) --

      The Amazon DataZone user who created the environment profile.

    • description (string) --

      The description to be updated as part of the UpdateEnvironmentProfile action.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which the environment profile is to be updated.

    • environmentBlueprintId (string) --

      The identifier of the blueprint of the environment profile that is to be updated.

    • id (string) --

      The identifier of the environment profile that is to be udpated.

    • name (string) --

      The name to be updated as part of the UpdateEnvironmentProfile action.

    • projectId (string) --

      The identifier of the project of the environment profile that is to be updated.

    • updatedAt (datetime) --

      The timestamp of when the environment profile was updated.

    • userParameters (list) --

      The user parameters to be updated as part of the UpdateEnvironmentProfile action.

      • (dict) --

        The details of user parameters of an environment blueprint.

        • defaultValue (string) --

          The default value of the parameter.

        • description (string) --

          The description of the parameter.

        • fieldType (string) --

          The filed type of the parameter.

        • isEditable (boolean) --

          Specifies whether the parameter is editable.

        • isOptional (boolean) --

          Specifies whether the custom parameter is optional.

        • keyName (string) --

          The key name of the parameter.

AcceptPredictions (new) Link ¶

Accepts automatically generated business-friendly metadata for your Amazon DataZone assets.

See also: AWS API Documentation

Request Syntax

client.accept_predictions(
    acceptChoices=[
        {
            'predictionChoice': 123,
            'predictionTarget': 'string'
        },
    ],
    acceptRule={
        'rule': 'ALL'|'NONE',
        'threshold': ...
    },
    clientToken='string',
    domainIdentifier='string',
    identifier='string',
    revision='string'
)
type acceptChoices

list

param acceptChoices
  • (dict) --

    Specifies the prediction (aka, the automatically generated piece of metadata) and the target (for example, a column name) that can be accepted.

    • predictionChoice (integer) --

      Specifies the prediction (aka, the automatically generated piece of metadata) that can be accepted.

    • predictionTarget (string) --

      Specifies the target (for example, a column name) where a prediction can be accepted.

type acceptRule

dict

param acceptRule

Specifies the rule (or the conditions) under which a prediction can be accepted.

  • rule (string) --

    Specifies whether you want to accept the top prediction for all targets or none.

  • threshold (float) --

    The confidence score that specifies the condition at which a prediction can be accepted.

type clientToken

string

param clientToken

A unique, case-sensitive identifier to ensure idempotency of the request. This field is automatically populated if not provided.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type identifier

string

param identifier

[REQUIRED]

type revision

string

param revision

rtype

dict

returns

Response Syntax

{
    'assetId': 'string',
    'domainId': 'string',
    'revision': 'string'
}

Response Structure

  • (dict) --

    • assetId (string) --

    • domainId (string) --

    • revision (string) --

ListProjectMemberships (new) Link ¶

Lists all members of the specified project.

See also: AWS API Documentation

Request Syntax

client.list_project_memberships(
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    projectIdentifier='string',
    sortBy='NAME',
    sortOrder='ASCENDING'|'DESCENDING'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which you want to list project memberships.

type maxResults

integer

param maxResults

The maximum number of memberships to return in a single call to ListProjectMemberships . When the number of memberships to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListProjectMemberships to list the next set of memberships.

type nextToken

string

param nextToken

When the number of memberships is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of memberships, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListProjectMemberships to list the next set of memberships.

type projectIdentifier

string

param projectIdentifier

[REQUIRED]

The identifier of the project whose memberships you want to list.

type sortBy

string

param sortBy

The method by which you want to sort the project memberships.

type sortOrder

string

param sortOrder

The sort order of the project memberships.

rtype

dict

returns

Response Syntax

{
    'members': [
        {
            'designation': 'PROJECT_OWNER'|'PROJECT_CONTRIBUTOR',
            'memberDetails': {
                'group': {
                    'groupId': 'string'
                },
                'user': {
                    'userId': 'string'
                }
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • members (list) --

      The members of the project.

      • (dict) --

        The details of a project member.

        • designation (string) --

          The designated role of a project member.

        • memberDetails (dict) --

          The membership details of a project member.

          • group (dict) --

            The group details of a project member.

            • groupId (string) --

              The identifier of the group in Amazon DataZone.

          • user (dict) --

            The user details of a project member.

            • userId (string) --

              The identifier of the Amazon DataZone user.

    • nextToken (string) --

      When the number of memberships is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of memberships, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListProjectMemberships to list the next set of memberships.

GetDataSource (new) Link ¶

Gets an Amazon DataZone data source.

See also: AWS API Documentation

Request Syntax

client.get_data_source(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the data source exists.

type identifier

string

param identifier

[REQUIRED]

The ID of the Amazon DataZone data source.

rtype

dict

returns

Response Syntax

{
    'assetFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'configuration': {
        'glueRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        },
        'redshiftRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'redshiftCredentialConfiguration': {
                'secretManagerArn': 'string'
            },
            'redshiftStorage': {
                'redshiftClusterSource': {
                    'clusterName': 'string'
                },
                'redshiftServerlessSource': {
                    'workgroupName': 'string'
                }
            },
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        }
    },
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'domainId': 'string',
    'enableSetting': 'ENABLED'|'DISABLED',
    'environmentId': 'string',
    'errorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'id': 'string',
    'lastRunAssetCount': 123,
    'lastRunAt': datetime(2015, 1, 1),
    'lastRunErrorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'lastRunStatus': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
    'name': 'string',
    'projectId': 'string',
    'publishOnImport': True|False,
    'recommendation': {
        'enableBusinessNameGeneration': True|False
    },
    'schedule': {
        'schedule': 'string',
        'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
    },
    'status': 'CREATING'|'FAILED_CREATION'|'READY'|'UPDATING'|'FAILED_UPDATE'|'RUNNING'|'DELETING'|'FAILED_DELETION',
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • assetFormsOutput (list) --

      The metadata forms attached to the assets created by this data source.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • configuration (dict) --

      The configuration of the data source.

      • glueRunConfiguration (dict) --

        The configuration of the Amazon Web Services Glue data source.

        • accountId (string) --

          The Amazon Web Services account ID included in the configuration details of the Amazon Web Services Glue data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Web Services Glue data source.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Web Services Glue data source.

        • relationalFilterConfigurations (list) --

          The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

      • redshiftRunConfiguration (dict) --

        The configuration of the Amazon Redshift data source.

        • accountId (string) --

          The ID of the Amazon Web Services account included in the configuration details of the Amazon Redshift data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Redshift data source.

        • redshiftCredentialConfiguration (dict) --

          The details of the credentials required to access an Amazon Redshift cluster.

          • secretManagerArn (string) --

            The ARN of a secret manager for an Amazon Redshift cluster.

        • redshiftStorage (dict) --

          The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.

          • redshiftClusterSource (dict) --

            The details of the Amazon Redshift cluster source.

            • clusterName (string) --

              The name of an Amazon Redshift cluster.

          • redshiftServerlessSource (dict) --

            The details of the Amazon Redshift Serverless workgroup source.

            • workgroupName (string) --

              The name of the Amazon Redshift Serverless workgroup.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Redshift data source.

        • relationalFilterConfigurations (list) --

          The relational filger configurations included in the configuration details of the Amazon Redshift data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

    • createdAt (datetime) --

      The timestamp of when the data source was created.

    • description (string) --

      The description of the data source.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the data source exists.

    • enableSetting (string) --

      Specifies whether this data source is enabled or not.

    • environmentId (string) --

      The ID of the environment where this data source creates and publishes assets,

    • errorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • id (string) --

      The ID of the data source.

    • lastRunAssetCount (integer) --

      The number of assets created by the data source during its last run.

    • lastRunAt (datetime) --

      The timestamp of the last run of the data source.

    • lastRunErrorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • lastRunStatus (string) --

      The status of the last run of the data source.

    • name (string) --

      The name of the data source.

    • projectId (string) --

      The ID of the project where the data source creates and publishes assets.

    • publishOnImport (boolean) --

      Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.

    • recommendation (dict) --

      • enableBusinessNameGeneration (boolean) --

        Specifies whether automatic business name generation is to be enabled or not as part of the recommendation configuration.

    • schedule (dict) --

      The schedule of the data source runs.

      • schedule (string) --

        The schedule of the data source runs.

      • timezone (string) --

        The timezone of the data source run.

    • status (string) --

      The status of the data source.

    • type (string) --

      The type of the data source.

    • updatedAt (datetime) --

      The timestamp of when the data source was updated.

ListSubscriptionRequests (new) Link ¶

Lists Amazon DataZone subscription requests.

See also: AWS API Documentation

Request Syntax

client.list_subscription_requests(
    approverProjectId='string',
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    owningProjectId='string',
    sortBy='CREATED_AT'|'UPDATED_AT',
    sortOrder='ASCENDING'|'DESCENDING',
    status='PENDING'|'ACCEPTED'|'REJECTED',
    subscribedListingId='string'
)
type approverProjectId

string

param approverProjectId

The identifier of the subscription request approver's project.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type maxResults

integer

param maxResults

The maximum number of subscription requests to return in a single call to ListSubscriptionRequests . When the number of subscription requests to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListSubscriptionRequests to list the next set of subscription requests.

type nextToken

string

param nextToken

When the number of subscription requests is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscription requests, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptionRequests to list the next set of subscription requests.

type owningProjectId

string

param owningProjectId

The identifier of the project for the subscription requests.

type sortBy

string

param sortBy

Specifies the way to sort the results of this action.

type sortOrder

string

param sortOrder

Specifies the sort order for the results of this action.

type status

string

param status

Specifies the status of the subscription requests.

type subscribedListingId

string

param subscribedListingId

The identifier of the subscribed listing.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'decisionComment': 'string',
            'domainId': 'string',
            'id': 'string',
            'requestReason': 'string',
            'reviewerId': 'string',
            'status': 'PENDING'|'ACCEPTED'|'REJECTED',
            'subscribedListings': [
                {
                    'description': 'string',
                    'id': 'string',
                    'item': {
                        'assetListing': {
                            'entityId': 'string',
                            'entityRevision': 'string',
                            'entityType': 'string',
                            'forms': 'string',
                            'glossaryTerms': [
                                {
                                    'name': 'string',
                                    'shortDescription': 'string'
                                },
                            ]
                        }
                    },
                    'name': 'string',
                    'ownerProjectId': 'string',
                    'ownerProjectName': 'string',
                    'revision': 'string'
                },
            ],
            'subscribedPrincipals': [
                {
                    'project': {
                        'id': 'string',
                        'name': 'string'
                    }
                },
            ],
            'updatedAt': datetime(2015, 1, 1),
            'updatedBy': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListSubscriptionRequests action.

      • (dict) --

        The details of the subscription request.

        • createdAt (datetime) --

          The timestamp of when a subscription request was created.

        • createdBy (string) --

          The Amazon DataZone user who created the subscription request.

        • decisionComment (string) --

          The decision comment of the subscription request.

        • domainId (string) --

          The identifier of the Amazon DataZone domain in which a subscription request exists.

        • id (string) --

          The identifier of the subscription request.

        • requestReason (string) --

          The reason for the subscription request.

        • reviewerId (string) --

          The identifier of the subscription request reviewer.

        • status (string) --

          The status of the subscription request.

        • subscribedListings (list) --

          The listings included in the subscription request.

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

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

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

        • subscribedPrincipals (list) --

          The principals included in the subscription request.

          • (dict) --

            The principal that has the subscription grant for the asset.

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

        • updatedAt (datetime) --

          The timestamp of when the subscription request was updated.

        • updatedBy (string) --

          The identifier of the Amazon DataZone user who updated the subscription request.

    • nextToken (string) --

      When the number of subscription requests is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of subscription requests, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListSubscriptionRequests to list the next set of subscription requests.

CancelSubscription (new) Link ¶

Cancels the subscription to the specified asset.

See also: AWS API Documentation

Request Syntax

client.cancel_subscription(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The unique identifier of the Amazon DataZone domain where the subscription request is being cancelled.

type identifier

string

param identifier

[REQUIRED]

The unique identifier of the subscription that is being cancelled.

rtype

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'
                    },
                ]
            }
        },
        '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 that specifies when the request to cancel the subscription was created.

    • createdBy (string) --

      Specifies the Amazon DataZone user who is cancelling the subscription.

    • domainId (string) --

      The unique identifier of the Amazon DataZone domain where the subscription is being cancelled.

    • id (string) --

      The identifier of the subscription.

    • retainPermissions (boolean) --

      Specifies whether the permissions to the asset are retained after the subscription is cancelled.

    • status (string) --

      The status of the request to cancel the subscription.

    • subscribedListing (dict) --

      The asset to which a subscription is being cancelled.

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

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

      • 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 Amazon DataZone user who is made a subscriber to the specified asset by the subscription that is being cancelled.

      • 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 unique ID of the subscripton request for the subscription that is being cancelled.

    • updatedAt (datetime) --

      The timestamp that specifies when the subscription was cancelled.

    • updatedBy (string) --

      The Amazon DataZone user that cancelled the subscription.

ListEnvironmentBlueprints (new) Link ¶

Lists blueprints in an Amazon DataZone environment.

See also: AWS API Documentation

Request Syntax

client.list_environment_blueprints(
    domainIdentifier='string',
    managed=True|False,
    maxResults=123,
    name='string',
    nextToken='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type managed

boolean

param managed

Specifies whether the environment blueprint is managed by Amazon DataZone.

type maxResults

integer

param maxResults

The maximum number of blueprints to return in a single call to ListEnvironmentBlueprints . When the number of blueprints to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListEnvironmentBlueprints to list the next set of blueprints.

type name

string

param name

The name of the Amazon DataZone environment.

type nextToken

string

param nextToken

When the number of blueprints in the environment is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of blueprints in the environment, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironmentBlueprints to list the next set of blueprints.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'description': 'string',
            'id': 'string',
            'name': 'string',
            'provider': 'string',
            'provisioningProperties': {
                'cloudFormation': {
                    'templateUrl': 'string'
                }
            },
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListEnvironmentBlueprints action.

      • (dict) --

        The details of an environment blueprint summary.

        • createdAt (datetime) --

          The timestamp of when an environment blueprint was created.

        • description (string) --

          The description of a blueprint.

        • id (string) --

          The identifier of the blueprint.

        • name (string) --

          The name of the blueprint.

        • provider (string) --

          The provider of the blueprint.

        • provisioningProperties (dict) --

          The provisioning properties of the blueprint.

          • cloudFormation (dict) --

            The cloud formation properties included as part of the provisioning properties of an environment blueprint.

            • templateUrl (string) --

              The template URL of the cloud formation provisioning properties of the environment blueprint.

        • updatedAt (datetime) --

          The timestamp of when the blueprint was enabled.

    • nextToken (string) --

      When the number of blueprints in the environment is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of blueprints in the environment, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListEnvironmentBlueprints to list the next set of blueprints.

GetSubscriptionRequestDetails (new) Link ¶

Gets the details of the specified subscription request.

See also: AWS API Documentation

Request Syntax

client.get_subscription_request_details(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which to get the subscription request details.

type identifier

string

param identifier

[REQUIRED]

The identifier of the subscription request the details of which to get.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'decisionComment': 'string',
    'domainId': 'string',
    'id': 'string',
    'requestReason': 'string',
    'reviewerId': 'string',
    'status': 'PENDING'|'ACCEPTED'|'REJECTED',
    'subscribedListings': [
        {
            'description': 'string',
            'id': 'string',
            'item': {
                'assetListing': {
                    'entityId': 'string',
                    'entityRevision': 'string',
                    'entityType': 'string',
                    'forms': 'string',
                    'glossaryTerms': [
                        {
                            'name': 'string',
                            'shortDescription': 'string'
                        },
                    ]
                }
            },
            'name': 'string',
            'ownerProjectId': 'string',
            'ownerProjectName': 'string',
            'revision': 'string'
        },
    ],
    'subscribedPrincipals': [
        {
            'project': {
                'id': 'string',
                'name': 'string'
            }
        },
    ],
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the specified subscription request was created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription request.

    • decisionComment (string) --

      The decision comment of the subscription request.

    • domainId (string) --

      The Amazon DataZone domain of the subscription request.

    • id (string) --

      The identifier of the subscription request.

    • requestReason (string) --

      The reason for the subscription request.

    • reviewerId (string) --

      The identifier of the Amazon DataZone user who reviewed the subscription request.

    • status (string) --

      The status of the subscription request.

    • subscribedListings (list) --

      The subscribed listings in the subscription request.

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

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

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

    • subscribedPrincipals (list) --

      The subscribed principals in the subscription request.

      • (dict) --

        The principal that has the subscription grant for the asset.

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

    • updatedAt (datetime) --

      The timestamp of when the subscription request was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription request.

DeleteAssetType (new) Link ¶

Deletes an asset type in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_asset_type(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the asset type is deleted.

type identifier

string

param identifier

[REQUIRED]

The identifier of the asset type that is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

GetFormType (new) Link ¶

Gets a metadata form type in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_form_type(
    domainIdentifier='string',
    formTypeIdentifier='string',
    revision='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this metadata form type exists.

type formTypeIdentifier

string

param formTypeIdentifier

[REQUIRED]

The ID of the metadata form type.

type revision

string

param revision

The revision of this metadata form type.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'imports': [
        {
            'name': 'string',
            'revision': 'string'
        },
    ],
    'model': {
        'smithy': 'string'
    },
    'name': 'string',
    'originDomainId': 'string',
    'originProjectId': 'string',
    'owningProjectId': 'string',
    'revision': 'string',
    'status': 'ENABLED'|'DISABLED'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when this metadata form type was created.

    • createdBy (string) --

      The Amazon DataZone user who created this metadata form type.

    • description (string) --

      The description of the metadata form type.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this metadata form type exists.

    • imports (list) --

      The imports of the metadata form type.

      • (dict) --

        The details of the import of the metadata form type.

        • name (string) --

          The name of the import.

        • revision (string) --

          The revision of the import.

    • model (dict) --

      The model of the metadata form type.

      • smithy (string) --

    • name (string) --

      The name of the metadata form type.

    • originDomainId (string) --

      The ID of the Amazon DataZone domain in which the metadata form type was originally created.

    • originProjectId (string) --

      The ID of the project in which this metadata form type was originally created.

    • owningProjectId (string) --

      The ID of the project that owns this metadata form type.

    • revision (string) --

      The revision of the metadata form type.

    • status (string) --

      The status of the metadata form type.

DeleteListing (new) Link ¶

See also: AWS API Documentation

Request Syntax

client.delete_listing(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

type identifier

string

param identifier

[REQUIRED]

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

RevokeSubscription (new) Link ¶

Revokes a specified subscription in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.revoke_subscription(
    domainIdentifier='string',
    identifier='string',
    retainPermissions=True|False
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain where you want to revoke a subscription.

type identifier

string

param identifier

[REQUIRED]

The identifier of the revoked subscription.

type retainPermissions

boolean

param retainPermissions

Specifies whether permissions are retained when the subscription is revoked.

rtype

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'
                    },
                ]
            }
        },
        '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 revoked.

    • createdBy (string) --

      The identifier of the user who revoked the subscription.

    • domainId (string) --

      The identifier of the Amazon DataZone domain where you want to revoke a subscription.

    • id (string) --

      The identifier of the revoked subscription.

    • retainPermissions (boolean) --

      Specifies whether permissions are retained when the subscription is revoked.

    • status (string) --

      The status of the revoked subscription.

    • subscribedListing (dict) --

      The subscribed listing of the revoked subscription.

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

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

      • 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 subscribed principal of the revoked subscription.

      • 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 identifier of the subscription request for the revoked subscription.

    • updatedAt (datetime) --

      The timestamp of when the subscription was revoked.

    • updatedBy (string) --

      The Amazon DataZone user who revoked the subscription.

CreateAssetRevision (new) Link ¶

Creates a revision of the asset.

See also: AWS API Documentation

Request Syntax

client.create_asset_revision(
    clientToken='string',
    description='string',
    domainIdentifier='string',
    formsInput=[
        {
            'content': 'string',
            'formName': 'string',
            'typeIdentifier': 'string',
            'typeRevision': 'string'
        },
    ],
    glossaryTerms=[
        'string',
    ],
    identifier='string',
    name='string',
    predictionConfiguration={
        'businessNameGeneration': {
            'enabled': True|False
        }
    },
    typeRevision='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type description

string

param description

The revised description of the asset.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The unique identifier of the domain where the asset is being revised.

type formsInput

list

param formsInput

The metadata forms to be attached to the asset as part of asset revision.

  • (dict) --

    The details of a metadata form.

    • content (string) --

      The content of the metadata form.

    • formName (string) -- [REQUIRED]

      The name of the metadata form.

    • typeIdentifier (string) --

      The ID of the metadata form type.

    • typeRevision (string) --

      The revision of the metadata form type.

type glossaryTerms

list

param glossaryTerms

The glossary terms to be attached to the asset as part of asset revision.

  • (string) --

type identifier

string

param identifier

[REQUIRED]

The identifier of the asset.

type name

string

param name

[REQUIRED]

Te revised name of the asset.

type predictionConfiguration

dict

param predictionConfiguration

The configuration of the automatically generated business-friendly metadata for the asset.

  • businessNameGeneration (dict) --

    The business name generation mechanism.

    • enabled (boolean) --

      Specifies whether the business name generation is enabled.

type typeRevision

string

param typeRevision

The revision type of the asset.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'externalIdentifier': 'string',
    'firstRevisionCreatedAt': datetime(2015, 1, 1),
    'firstRevisionCreatedBy': 'string',
    'formsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'listing': {
        'listingId': 'string',
        'listingStatus': 'CREATING'|'ACTIVE'|'INACTIVE'
    },
    'name': 'string',
    'owningProjectId': 'string',
    'predictionConfiguration': {
        'businessNameGeneration': {
            'enabled': True|False
        }
    },
    'readOnlyFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'revision': 'string',
    'typeIdentifier': 'string',
    'typeRevision': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the asset revision occured.

    • createdBy (string) --

      The Amazon DataZone user who performed the asset revision.

    • description (string) --

      The revised asset description.

    • domainId (string) --

      The unique identifier of the Amazon DataZone domain where the asset was revised.

    • externalIdentifier (string) --

    • firstRevisionCreatedAt (datetime) --

      The timestamp of when the first asset revision occured.

    • firstRevisionCreatedBy (string) --

      The Amazon DataZone user who performed the first asset revision.

    • formsOutput (list) --

      The metadata forms that were attached to the asset as part of the asset revision.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • glossaryTerms (list) --

      The glossary terms that were attached to the asset as part of asset revision.

      • (string) --

    • id (string) --

      The unique identifier of the asset revision.

    • listing (dict) --

      • listingId (string) --

        The identifier of an asset published in an Amazon DataZone catalog.

      • listingStatus (string) --

        The status of an asset published in an Amazon DataZone catalog.

    • name (string) --

      The revised name of the asset.

    • owningProjectId (string) --

      The unique identifier of the revised project that owns the asset.

    • predictionConfiguration (dict) --

      The configuration of the automatically generated business-friendly metadata for the asset.

      • businessNameGeneration (dict) --

        The business name generation mechanism.

        • enabled (boolean) --

          Specifies whether the business name generation is enabled.

    • readOnlyFormsOutput (list) --

      The read-only metadata forms that were attached to the asset as part of the asset revision.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • revision (string) --

      The revision of the asset.

    • typeIdentifier (string) --

      The identifier of the revision type.

    • typeRevision (string) --

      The revision type of the asset.

StartDataSourceRun (new) Link ¶

Start the run of the specified data source in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.start_data_source_run(
    clientToken='string',
    dataSourceIdentifier='string',
    domainIdentifier='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type dataSourceIdentifier

string

param dataSourceIdentifier

[REQUIRED]

The identifier of the data source.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which to start a data source run.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'dataSourceConfigurationSnapshot': 'string',
    'dataSourceId': 'string',
    'domainId': 'string',
    'errorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'id': 'string',
    'projectId': 'string',
    'runStatisticsForAssets': {
        'added': 123,
        'failed': 123,
        'skipped': 123,
        'unchanged': 123,
        'updated': 123
    },
    'startedAt': datetime(2015, 1, 1),
    'status': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
    'stoppedAt': datetime(2015, 1, 1),
    'type': 'PRIORITIZED'|'SCHEDULED',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when data source run was created.

    • dataSourceConfigurationSnapshot (string) --

      The configuration snapshot of the data source that is being run.

    • dataSourceId (string) --

      The identifier of the data source.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which to start a data source run.

    • errorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • id (string) --

      The identifier of the data source run.

    • projectId (string) --

      The identifier of the project.

    • runStatisticsForAssets (dict) --

      Specifies run statistics for assets.

      • added (integer) --

        The added statistic for the data source run.

      • failed (integer) --

        The failed statistic for the data source run.

      • skipped (integer) --

        The skipped statistic for the data source run.

      • unchanged (integer) --

        The unchanged statistic for the data source run.

      • updated (integer) --

        The updated statistic for the data source run.

    • startedAt (datetime) --

      The timestamp of when the data source run was started.

    • status (string) --

      The status of the data source run.

    • stoppedAt (datetime) --

      The timestamp of when the data source run was stopped.

    • type (string) --

      The type of the data source run.

    • updatedAt (datetime) --

      The timestamp of when the data source run was updated.

UpdateGroupProfile (new) Link ¶

Updates the specified group profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_group_profile(
    domainIdentifier='string',
    groupIdentifier='string',
    status='ASSIGNED'|'NOT_ASSIGNED'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a group profile is updated.

type groupIdentifier

string

param groupIdentifier

[REQUIRED]

The identifier of the group profile that is updated.

type status

string

param status

[REQUIRED]

The status of the group profile that is updated.

rtype

dict

returns

Response Syntax

{
    'domainId': 'string',
    'groupName': 'string',
    'id': 'string',
    'status': 'ASSIGNED'|'NOT_ASSIGNED'
}

Response Structure

  • (dict) --

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a group profile is updated.

    • groupName (string) --

      The name of the group profile that is updated.

    • id (string) --

      The identifier of the group profile that is updated.

    • status (string) --

      The status of the group profile that is updated.

GetEnvironmentBlueprintConfiguration (new) Link ¶

Gets the blueprint configuration in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_environment_blueprint_configuration(
    domainIdentifier='string',
    environmentBlueprintIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain where this blueprint exists.

type environmentBlueprintIdentifier

string

param environmentBlueprintIdentifier

[REQUIRED]

He ID of the blueprint.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'domainId': 'string',
    'enabledRegions': [
        'string',
    ],
    'environmentBlueprintId': 'string',
    'manageAccessRoleArn': 'string',
    'provisioningRoleArn': 'string',
    'regionalParameters': {
        'string': {
            'string': 'string'
        }
    },
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when this blueprint was created.

    • domainId (string) --

      The ID of the Amazon DataZone domain where this blueprint exists.

    • enabledRegions (list) --

      The Amazon Web Services regions in which this blueprint is enabled.

      • (string) --

    • environmentBlueprintId (string) --

      The ID of the blueprint.

    • manageAccessRoleArn (string) --

      The ARN of the manage access role with which this blueprint is created.

    • provisioningRoleArn (string) --

      The ARN of the provisioning role with which this blueprint is created.

    • regionalParameters (dict) --

      The regional parameters of the blueprint.

      • (string) --

        • (dict) --

          • (string) --

            • (string) --

    • updatedAt (datetime) --

      The timestamp of when this blueprint was upated.

DeleteDomain (new) Link ¶

Deletes a Amazon DataZone domain.

See also: AWS API Documentation

Request Syntax

client.delete_domain(
    clientToken='string',
    identifier='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type identifier

string

param identifier

[REQUIRED]

The identifier of the Amazon Web Services domain that is to be deleted.

rtype

dict

returns

Response Syntax

{
    'status': 'CREATING'|'AVAILABLE'|'CREATION_FAILED'|'DELETING'|'DELETED'|'DELETION_FAILED'
}

Response Structure

  • (dict) --

    • status (string) --

      The status of the domain.

UpdateDomain (new) Link ¶

Updates a Amazon DataZone domain.

See also: AWS API Documentation

Request Syntax

client.update_domain(
    clientToken='string',
    description='string',
    domainExecutionRole='string',
    identifier='string',
    name='string',
    singleSignOn={
        'type': 'IAM_IDC'|'DISABLED',
        'userAssignment': 'AUTOMATIC'|'MANUAL'
    }
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type description

string

param description

The description to be updated as part of the UpdateDomain action.

type domainExecutionRole

string

param domainExecutionRole

The domain execution role to be updated as part of the UpdateDomain action.

type identifier

string

param identifier

[REQUIRED]

The ID of the Amazon Web Services domain that is to be updated.

type name

string

param name

The name to be updated as part of the UpdateDomain action.

type singleSignOn

dict

param singleSignOn

The single sign-on option to be updated as part of the UpdateDomain action.

  • type (string) --

    The type of single sign-on in Amazon DataZone.

  • userAssignment (string) --

    The single sign-on user assignment in Amazon DataZone.

rtype

dict

returns

Response Syntax

{
    'description': 'string',
    'domainExecutionRole': 'string',
    'id': 'string',
    'lastUpdatedAt': datetime(2015, 1, 1),
    'name': 'string',
    'singleSignOn': {
        'type': 'IAM_IDC'|'DISABLED',
        'userAssignment': 'AUTOMATIC'|'MANUAL'
    }
}

Response Structure

  • (dict) --

    • description (string) --

      The description to be updated as part of the UpdateDomain action.

    • domainExecutionRole (string) --

      The domain execution role to be updated as part of the UpdateDomain action.

    • id (string) --

      The identifier of the Amazon DataZone domain.

    • lastUpdatedAt (datetime) --

      Specifies the timestamp of when the domain was last updated.

    • name (string) --

      The name to be updated as part of the UpdateDomain action.

    • singleSignOn (dict) --

      The single sign-on option of the Amazon DataZone domain.

      • type (string) --

        The type of single sign-on in Amazon DataZone.

      • userAssignment (string) --

        The single sign-on user assignment in Amazon DataZone.

DeleteSubscriptionTarget (new) Link ¶

Deletes a subscription target in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_subscription_target(
    domainIdentifier='string',
    environmentIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the subscription target is deleted.

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The ID of the Amazon DataZone environment in which the subscription target is deleted.

type identifier

string

param identifier

[REQUIRED]

The ID of the subscription target that is deleted.

returns

None

CreateGlossary (new) Link ¶

Creates an Amazon DataZone business glossary.

See also: AWS API Documentation

Request Syntax

client.create_glossary(
    clientToken='string',
    description='string',
    domainIdentifier='string',
    name='string',
    owningProjectIdentifier='string',
    status='DISABLED'|'ENABLED'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type description

string

param description

The description of this business glossary.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this business glossary is created.

type name

string

param name

[REQUIRED]

The name of this business glossary.

type owningProjectIdentifier

string

param owningProjectIdentifier

[REQUIRED]

The ID of the project that currently owns business glossary.

type status

string

param status

The status of this business glossary.

rtype

dict

returns

Response Syntax

{
    'description': 'string',
    'domainId': 'string',
    'id': 'string',
    'name': 'string',
    'owningProjectId': 'string',
    'status': 'DISABLED'|'ENABLED'
}

Response Structure

  • (dict) --

    • description (string) --

      The description of this business glossary.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this business glossary is created.

    • id (string) --

      The ID of this business glossary.

    • name (string) --

      The name of this business glossary.

    • owningProjectId (string) --

      The ID of the project that currently owns this business glossary.

    • status (string) --

      The status of this business glossary.

CreateUserProfile (new) Link ¶

Creates a user profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.create_user_profile(
    clientToken='string',
    domainIdentifier='string',
    userIdentifier='string',
    userType='IAM_USER'|'IAM_ROLE'|'SSO_USER'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a user profile is created.

type userIdentifier

string

param userIdentifier

[REQUIRED]

The identifier of the user for which the user profile is created.

type userType

string

param userType

The user type of the user for which the user profile is created.

rtype

dict

returns

Response Syntax

{
    'details': {
        'iam': {
            'arn': 'string'
        },
        'sso': {
            'firstName': 'string',
            'lastName': 'string',
            'username': 'string'
        }
    },
    'domainId': 'string',
    'id': 'string',
    'status': 'ASSIGNED'|'NOT_ASSIGNED'|'ACTIVATED'|'DEACTIVATED',
    'type': 'IAM'|'SSO'
}

Response Structure

  • (dict) --

    • details (dict) --

      The details of the user profile in Amazon DataZone.

      • iam (dict) --

        The IAM details included in the user profile details.

        • arn (string) --

          The ARN of an IAM user profile in Amazon DataZone.

      • sso (dict) --

        The single sign-on details included in the user profile details.

        • firstName (string) --

          The first name included in the single sign-on details of the user profile.

        • lastName (string) --

          The last name included in the single sign-on details of the user profile.

        • username (string) --

          The username included in the single sign-on details of the user profile.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a user profile is created.

    • id (string) --

      The identifier of the user profile.

    • status (string) --

      The status of the user profile.

    • type (string) --

      The type of the user profile.

CreateProject (new) Link ¶

Creates an Amazon DataZone project.

See also: AWS API Documentation

Request Syntax

client.create_project(
    description='string',
    domainIdentifier='string',
    glossaryTerms=[
        'string',
    ],
    name='string'
)
type description

string

param description

The description of the Amazon DataZone project.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this project is created.

type glossaryTerms

list

param glossaryTerms

The glossary terms that can be used in this Amazon DataZone project.

  • (string) --

type name

string

param name

[REQUIRED]

The name of the Amazon DataZone project.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastUpdatedAt': datetime(2015, 1, 1),
    'name': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the project was created.

    • createdBy (string) --

      The Amazon DataZone user who created the project.

    • description (string) --

      The description of the project.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which the project was created.

    • glossaryTerms (list) --

      The glossary terms that can be used in the project.

      • (string) --

    • id (string) --

      The ID of the Amazon DataZone project.

    • lastUpdatedAt (datetime) --

      The timestamp of when the project was last updated.

    • name (string) --

      The name of the project.

ListDataSourceRunActivities (new) Link ¶

Lists data source run activities.

See also: AWS API Documentation

Request Syntax

client.list_data_source_run_activities(
    domainIdentifier='string',
    identifier='string',
    maxResults=123,
    nextToken='string',
    status='FAILED'|'PUBLISHING_FAILED'|'SUCCEEDED_CREATED'|'SUCCEEDED_UPDATED'|'SKIPPED_ALREADY_IMPORTED'|'SKIPPED_ARCHIVED'|'SKIPPED_NO_ACCESS'|'UNCHANGED'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which to list data source run activities.

type identifier

string

param identifier

[REQUIRED]

The identifier of the data source run.

type maxResults

integer

param maxResults

The maximum number of activities to return in a single call to ListDataSourceRunActivities . When the number of activities to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListDataSourceRunActivities to list the next set of activities.

type nextToken

string

param nextToken

When the number of activities is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of activities, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDataSourceRunActivities to list the next set of activities.

type status

string

param status

The status of the data source run.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'dataAssetId': 'string',
            'dataAssetStatus': 'FAILED'|'PUBLISHING_FAILED'|'SUCCEEDED_CREATED'|'SUCCEEDED_UPDATED'|'SKIPPED_ALREADY_IMPORTED'|'SKIPPED_ARCHIVED'|'SKIPPED_NO_ACCESS'|'UNCHANGED',
            'dataSourceRunId': 'string',
            'database': 'string',
            'errorMessage': {
                'errorDetail': 'string',
                'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
            },
            'projectId': 'string',
            'technicalDescription': 'string',
            'technicalName': 'string',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListDataSourceRunActivities action.

      • (dict) --

        The activity details of the data source run.

        • createdAt (datetime) --

          The timestamp of when data source run activity was created.

        • dataAssetId (string) --

          The identifier of the asset included in the data source run activity.

        • dataAssetStatus (string) --

          The status of the asset included in the data source run activity.

        • dataSourceRunId (string) --

          The identifier of the data source for the data source run activity.

        • database (string) --

          The database included in the data source run activity.

        • errorMessage (dict) --

          The details of the error message that is returned if the operation cannot be successfully completed.

          • errorDetail (string) --

            The details of the error message that is returned if the operation cannot be successfully completed.

          • errorType (string) --

            The type of the error message that is returned if the operation cannot be successfully completed.

        • projectId (string) --

          The project ID included in the data source run activity.

        • technicalDescription (string) --

          The technical description included in the data source run activity.

        • technicalName (string) --

          The technical name included in the data source run activity.

        • updatedAt (datetime) --

          The timestamp of when data source run activity was updated.

    • nextToken (string) --

      When the number of activities is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of activities, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDataSourceRunActivities to list the next set of activities.

GetSubscriptionGrant (new) Link ¶

Gets the subscription grant in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_subscription_grant(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

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

type identifier

string

param identifier

[REQUIRED]

The ID of the subscription grant.

rtype

dict

returns

Response Syntax

{
    'assets': [
        {
            'assetId': 'string',
            'assetRevision': 'string',
            'failureCause': {
                'message': 'string'
            },
            'failureTimestamp': datetime(2015, 1, 1),
            'grantedTimestamp': datetime(2015, 1, 1),
            'status': 'GRANT_PENDING'|'REVOKE_PENDING'|'GRANT_IN_PROGRESS'|'REVOKE_IN_PROGRESS'|'GRANTED'|'REVOKED'|'GRANT_FAILED'|'REVOKE_FAILED',
            'targetName': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'grantedEntity': {
        'listing': {
            'id': 'string',
            'revision': 'string'
        }
    },
    'id': 'string',
    'status': 'PENDING'|'IN_PROGRESS'|'GRANT_FAILED'|'REVOKE_FAILED'|'GRANT_AND_REVOKE_FAILED'|'COMPLETED'|'INACCESSIBLE',
    'subscriptionId': 'string',
    'subscriptionTargetId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • assets (list) --

      The assets for which the subscription grant is created.

      • (dict) --

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

        • assetId (string) --

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

        • assetRevision (string) --

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

        • failureCause (dict) --

          The failure cause included in the details of the asset for which the subscription grant is created.

          • message (string) --

            The description of the error message.

        • failureTimestamp (datetime) --

          The failure timestamp included in the details of the asset for which the subscription grant is created.

        • grantedTimestamp (datetime) --

          The timestamp of when the subscription grant to the asset is created.

        • status (string) --

          The status of the asset for which the subscription grant is created.

        • targetName (string) --

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

    • createdAt (datetime) --

      The timestamp of when the subscription grant is created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription grant.

    • domainId (string) --

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

    • grantedEntity (dict) --

      The entity to which the subscription is granted.

      • listing (dict) --

        The listing for which a subscription is granted.

        • id (string) --

          An identifier of a revision of an asset published in a Amazon DataZone catalog.

        • revision (string) --

          The details of a revision of an asset published in a Amazon DataZone catalog.

    • id (string) --

      The ID of the subscription grant.

    • status (string) --

      The status of the subscription grant.

    • subscriptionId (string) --

      The identifier of the subscription.

    • subscriptionTargetId (string) --

      The subscription target ID associated with the subscription grant.

    • updatedAt (datetime) --

      The timestamp of when the subscription grant was upated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription grant.

SearchGroupProfiles (new) Link ¶

Searches group profiles in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.search_group_profiles(
    domainIdentifier='string',
    groupType='SSO_GROUP'|'DATAZONE_SSO_GROUP',
    maxResults=123,
    nextToken='string',
    searchText='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which you want to search group profiles.

type groupType

string

param groupType

[REQUIRED]

The group type for which to search.

type maxResults

integer

param maxResults

The maximum number of results to return in a single call to SearchGroupProfiles . When the number of results to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to SearchGroupProfiles to list the next set of results.

type nextToken

string

param nextToken

When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchGroupProfiles to list the next set of results.

type searchText

string

param searchText

Specifies the text for which to search.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'domainId': 'string',
            'groupName': 'string',
            'id': 'string',
            'status': 'ASSIGNED'|'NOT_ASSIGNED'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the SearchGroupProfiles action.

      • (dict) --

        The details of a group profile.

        • domainId (string) --

          The ID of the Amazon DataZone domain of a group profile.

        • groupName (string) --

          The group name of a group profile.

        • id (string) --

          The ID of a group profile.

        • status (string) --

          The status of a group profile.

    • nextToken (string) --

      When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchGroupProfiles to list the next set of results.

DeleteDataSource (new) Link ¶

Deletes a data source in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_data_source(
    clientToken='string',
    domainIdentifier='string',
    identifier='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the data source is deleted.

type identifier

string

param identifier

[REQUIRED]

The identifier of the data source that is deleted.

rtype

dict

returns

Response Syntax

{
    'assetFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'configuration': {
        'glueRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        },
        'redshiftRunConfiguration': {
            'accountId': 'string',
            'dataAccessRole': 'string',
            'redshiftCredentialConfiguration': {
                'secretManagerArn': 'string'
            },
            'redshiftStorage': {
                'redshiftClusterSource': {
                    'clusterName': 'string'
                },
                'redshiftServerlessSource': {
                    'workgroupName': 'string'
                }
            },
            'region': 'string',
            'relationalFilterConfigurations': [
                {
                    'databaseName': 'string',
                    'filterExpressions': [
                        {
                            'expression': 'string',
                            'type': 'INCLUDE'|'EXCLUDE'
                        },
                    ],
                    'schemaName': 'string'
                },
            ]
        }
    },
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'domainId': 'string',
    'enableSetting': 'ENABLED'|'DISABLED',
    'environmentId': 'string',
    'errorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'id': 'string',
    'lastRunAt': datetime(2015, 1, 1),
    'lastRunErrorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'lastRunStatus': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
    'name': 'string',
    'projectId': 'string',
    'publishOnImport': True|False,
    'schedule': {
        'schedule': 'string',
        'timezone': 'UTC'|'AFRICA_JOHANNESBURG'|'AMERICA_MONTREAL'|'AMERICA_SAO_PAULO'|'ASIA_BAHRAIN'|'ASIA_BANGKOK'|'ASIA_CALCUTTA'|'ASIA_DUBAI'|'ASIA_HONG_KONG'|'ASIA_JAKARTA'|'ASIA_KUALA_LUMPUR'|'ASIA_SEOUL'|'ASIA_SHANGHAI'|'ASIA_SINGAPORE'|'ASIA_TAIPEI'|'ASIA_TOKYO'|'AUSTRALIA_MELBOURNE'|'AUSTRALIA_SYDNEY'|'CANADA_CENTRAL'|'CET'|'CST6CDT'|'ETC_GMT'|'ETC_GMT0'|'ETC_GMT_ADD_0'|'ETC_GMT_ADD_1'|'ETC_GMT_ADD_10'|'ETC_GMT_ADD_11'|'ETC_GMT_ADD_12'|'ETC_GMT_ADD_2'|'ETC_GMT_ADD_3'|'ETC_GMT_ADD_4'|'ETC_GMT_ADD_5'|'ETC_GMT_ADD_6'|'ETC_GMT_ADD_7'|'ETC_GMT_ADD_8'|'ETC_GMT_ADD_9'|'ETC_GMT_NEG_0'|'ETC_GMT_NEG_1'|'ETC_GMT_NEG_10'|'ETC_GMT_NEG_11'|'ETC_GMT_NEG_12'|'ETC_GMT_NEG_13'|'ETC_GMT_NEG_14'|'ETC_GMT_NEG_2'|'ETC_GMT_NEG_3'|'ETC_GMT_NEG_4'|'ETC_GMT_NEG_5'|'ETC_GMT_NEG_6'|'ETC_GMT_NEG_7'|'ETC_GMT_NEG_8'|'ETC_GMT_NEG_9'|'EUROPE_DUBLIN'|'EUROPE_LONDON'|'EUROPE_PARIS'|'EUROPE_STOCKHOLM'|'EUROPE_ZURICH'|'ISRAEL'|'MEXICO_GENERAL'|'MST7MDT'|'PACIFIC_AUCKLAND'|'US_CENTRAL'|'US_EASTERN'|'US_MOUNTAIN'|'US_PACIFIC'
    },
    'status': 'CREATING'|'FAILED_CREATION'|'READY'|'UPDATING'|'FAILED_UPDATE'|'RUNNING'|'DELETING'|'FAILED_DELETION',
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • assetFormsOutput (list) --

      The asset data forms associated with this data source.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • configuration (dict) --

      The configuration of the data source that is deleted.

      • glueRunConfiguration (dict) --

        The configuration of the Amazon Web Services Glue data source.

        • accountId (string) --

          The Amazon Web Services account ID included in the configuration details of the Amazon Web Services Glue data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Web Services Glue data source.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Web Services Glue data source.

        • relationalFilterConfigurations (list) --

          The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

      • redshiftRunConfiguration (dict) --

        The configuration of the Amazon Redshift data source.

        • accountId (string) --

          The ID of the Amazon Web Services account included in the configuration details of the Amazon Redshift data source.

        • dataAccessRole (string) --

          The data access role included in the configuration details of the Amazon Redshift data source.

        • redshiftCredentialConfiguration (dict) --

          The details of the credentials required to access an Amazon Redshift cluster.

          • secretManagerArn (string) --

            The ARN of a secret manager for an Amazon Redshift cluster.

        • redshiftStorage (dict) --

          The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.

          • redshiftClusterSource (dict) --

            The details of the Amazon Redshift cluster source.

            • clusterName (string) --

              The name of an Amazon Redshift cluster.

          • redshiftServerlessSource (dict) --

            The details of the Amazon Redshift Serverless workgroup source.

            • workgroupName (string) --

              The name of the Amazon Redshift Serverless workgroup.

        • region (string) --

          The Amazon Web Services region included in the configuration details of the Amazon Redshift data source.

        • relationalFilterConfigurations (list) --

          The relational filger configurations included in the configuration details of the Amazon Redshift data source.

          • (dict) --

            The relational filter configuration for the data source.

            • databaseName (string) --

              The database name specified in the relational filter configuration for the data source.

            • filterExpressions (list) --

              The filter expressions specified in the relational filter configuration for the data source.

              • (dict) --

                A filter expression in Amazon DataZone.

                • expression (string) --

                  The search filter expression.

                • type (string) --

                  The search filter explresison type.

            • schemaName (string) --

              The schema name specified in the relational filter configuration for the data source.

    • createdAt (datetime) --

      The timestamp of when this data source was created.

    • description (string) --

      The description of the data source that is deleted.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the data source is deleted.

    • enableSetting (string) --

      The enable setting of the data source that specifies whether the data source is enabled or disabled.

    • environmentId (string) --

      The ID of the environemnt associated with this data source.

    • errorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • id (string) --

      The ID of the data source that is deleted.

    • lastRunAt (datetime) --

      The timestamp of when the data source was last run.

    • lastRunErrorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • lastRunStatus (string) --

      The status of the last run of this data source.

    • name (string) --

      The name of the data source that is deleted.

    • projectId (string) --

      The ID of the project in which this data source exists and from which it's deleted.

    • publishOnImport (boolean) --

      Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.

    • schedule (dict) --

      The schedule of runs for this data source.

      • schedule (string) --

        The schedule of the data source runs.

      • timezone (string) --

        The timezone of the data source run.

    • status (string) --

      The status of this data source.

    • type (string) --

      The type of this data source.

    • updatedAt (datetime) --

      The timestamp of when this data source was updated.

UpdateProject (new) Link ¶

Updates the specified project in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_project(
    description='string',
    domainIdentifier='string',
    glossaryTerms=[
        'string',
    ],
    identifier='string',
    name='string'
)
type description

string

param description

The description to be updated as part of the UpdateProject action.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a project is to be updated.

type glossaryTerms

list

param glossaryTerms

The glossary terms to be updated as part of the UpdateProject action.

  • (string) --

type identifier

string

param identifier

[REQUIRED]

The identifier of the project that is to be updated.

type name

string

param name

The name to be updated as part of the UpdateProject action.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastUpdatedAt': datetime(2015, 1, 1),
    'name': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the project was created.

    • createdBy (string) --

      The Amazon DataZone user who created the project.

    • description (string) --

      The description of the project that is to be updated.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a project is updated.

    • glossaryTerms (list) --

      The glossary terms of the project that are to be updated.

      • (string) --

    • id (string) --

      The identifier of the project that is to be updated.

    • lastUpdatedAt (datetime) --

      The timestamp of when the project was last updated.

    • name (string) --

      The name of the project that is to be updated.

DeleteEnvironment (new) Link ¶

Deletes an environment in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_environment(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the environment is deleted.

type identifier

string

param identifier

[REQUIRED]

The identifier of the environment that is to be deleted.

returns

None

GetGlossary (new) Link ¶

Gets a business glossary in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_glossary(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this business glossary exists.

type identifier

string

param identifier

[REQUIRED]

The ID of the business glossary.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'id': 'string',
    'name': 'string',
    'owningProjectId': 'string',
    'status': 'DISABLED'|'ENABLED',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when this business glossary was created.

    • createdBy (string) --

      The Amazon DataZone user who created this business glossary.

    • description (string) --

      The description of the business glossary.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this business glossary exists.

    • id (string) --

      The ID of the business glossary.

    • name (string) --

      The name of the business glossary.

    • owningProjectId (string) --

      The ID of the project that owns this business glossary.

    • status (string) --

      The status of the business glossary.

    • updatedAt (datetime) --

      The timestamp of when the business glossary was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the business glossary.

ListTagsForResource (new) Link ¶

Lists tags for the specified resource in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.list_tags_for_resource(
    resourceArn='string'
)
type resourceArn

string

param resourceArn

[REQUIRED]

The ARN of the resource whose tags you want to list.

rtype

dict

returns

Response Syntax

{
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • tags (dict) --

      The tags of the specified resource.

      • (string) --

        • (string) --

ListDataSourceRuns (new) Link ¶

Lists data source runs in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.list_data_source_runs(
    dataSourceIdentifier='string',
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    status='REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS'
)
type dataSourceIdentifier

string

param dataSourceIdentifier

[REQUIRED]

The identifier of the data source.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which to invoke the ListDataSourceRuns action.

type maxResults

integer

param maxResults

The maximum number of runs to return in a single call to ListDataSourceRuns . When the number of runs to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListDataSourceRuns to list the next set of runs.

type nextToken

string

param nextToken

When the number of runs is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of runs, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDataSourceRuns to list the next set of runs.

type status

string

param status

The status of the data source.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'dataSourceId': 'string',
            'errorMessage': {
                'errorDetail': 'string',
                'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
            },
            'id': 'string',
            'projectId': 'string',
            'runStatisticsForAssets': {
                'added': 123,
                'failed': 123,
                'skipped': 123,
                'unchanged': 123,
                'updated': 123
            },
            'startedAt': datetime(2015, 1, 1),
            'status': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
            'stoppedAt': datetime(2015, 1, 1),
            'type': 'PRIORITIZED'|'SCHEDULED',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListDataSourceRuns action.

      • (dict) --

        The details of a data source run.

        • createdAt (datetime) --

          The timestamp of when a data source run was created.

        • dataSourceId (string) --

          The identifier of the data source of the data source run.

        • errorMessage (dict) --

          The details of the error message that is returned if the operation cannot be successfully completed.

          • errorDetail (string) --

            The details of the error message that is returned if the operation cannot be successfully completed.

          • errorType (string) --

            The type of the error message that is returned if the operation cannot be successfully completed.

        • id (string) --

          The identifier of the data source run.

        • projectId (string) --

          The project ID of the data source run.

        • runStatisticsForAssets (dict) --

          The asset statistics from the data source run.

          • added (integer) --

            The added statistic for the data source run.

          • failed (integer) --

            The failed statistic for the data source run.

          • skipped (integer) --

            The skipped statistic for the data source run.

          • unchanged (integer) --

            The unchanged statistic for the data source run.

          • updated (integer) --

            The updated statistic for the data source run.

        • startedAt (datetime) --

          The timestamp of when a data source run was started.

        • status (string) --

          The status of the data source run.

        • stoppedAt (datetime) --

          The timestamp of when a data source run was stopped.

        • type (string) --

          The type of the data source run.

        • updatedAt (datetime) --

          The timestamp of when a data source run was updated.

    • nextToken (string) --

      When the number of runs is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of runs, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDataSourceRuns to list the next set of runs.

CreateAssetType (new) Link ¶

Creates a custom asset type.

See also: AWS API Documentation

Request Syntax

client.create_asset_type(
    description='string',
    domainIdentifier='string',
    formsInput={
        'string': {
            'required': True|False,
            'typeIdentifier': 'string',
            'typeRevision': 'string'
        }
    },
    name='string',
    owningProjectIdentifier='string'
)
type description

string

param description

The descripton of the custom asset type.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The unique identifier of the Amazon DataZone domain where the custom asset type is being created.

type formsInput

dict

param formsInput

[REQUIRED]

The metadata forms that are to be attached to the custom asset type.

  • (string) --

    • (dict) --

      The details of the form entry.

      • required (boolean) --

        Specifies whether a form entry is required.

      • typeIdentifier (string) -- [REQUIRED]

        The type ID of the form entry.

      • typeRevision (string) -- [REQUIRED]

        The type revision of the form entry.

type name

string

param name

[REQUIRED]

The name of the custom asset type.

type owningProjectIdentifier

string

param owningProjectIdentifier

[REQUIRED]

The identifier of the Amazon DataZone project that is to own the custom asset type.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'formsOutput': {
        'string': {
            'required': True|False,
            'typeName': 'string',
            'typeRevision': 'string'
        }
    },
    'name': 'string',
    'originDomainId': 'string',
    'originProjectId': 'string',
    'owningProjectId': 'string',
    'revision': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the asset type is to be created.

    • createdBy (string) --

      The Amazon DataZone user who creates this custom asset type.

    • description (string) --

      The description of the custom asset type.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the asset type was created.

    • formsOutput (dict) --

      The metadata forms that are attached to the asset type.

      • (string) --

        • (dict) --

          The details of the form entry.

          • required (boolean) --

            Specifies whether a form entry is required.

          • typeName (string) --

            The name of the type of the form entry.

          • typeRevision (string) --

            The type revision of the form entry.

    • name (string) --

      The name of the asset type.

    • originDomainId (string) --

      The ID of the Amazon DataZone domain where the asset type was originally created.

    • originProjectId (string) --

      The ID of the Amazon DataZone project where the asset type was originally created.

    • owningProjectId (string) --

      The ID of the Amazon DataZone project that currently owns this asset type.

    • revision (string) --

      The revision of the custom asset type.

    • updatedAt (datetime) --

      The timestamp of when the custom type was created.

    • updatedBy (string) --

      The Amazon DataZone user that created the custom asset type.

ListAssetRevisions (new) Link ¶

Lists the revisions for the asset.

See also: AWS API Documentation

Request Syntax

client.list_asset_revisions(
    domainIdentifier='string',
    identifier='string',
    maxResults=123,
    nextToken='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the domain.

type identifier

string

param identifier

[REQUIRED]

The identifier of the asset.

type maxResults

integer

param maxResults

The maximum number of revisions to return in a single call to ListAssetRevisions . When the number of revisions to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListAssetRevisions to list the next set of revisions.

type nextToken

string

param nextToken

When the number of revisions is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of revisions, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListAssetRevisions to list the next set of revisions.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'domainId': 'string',
            'id': 'string',
            'revision': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListAssetRevisions action.

      • (dict) --

        The revision of an inventory asset.

        • createdAt (datetime) --

          The timestamp of when an inventory asset revison was created.

        • createdBy (string) --

          The Amazon DataZone user who created the asset revision.

        • domainId (string) --

          The Amazon DataZone user who created the inventory asset.

        • id (string) --

          The identifier of the inventory asset revision.

        • revision (string) --

          The revision details of the inventory asset.

    • nextToken (string) --

      When the number of revisions is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of revisions, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListAssetRevisions to list the next set of revisions.

ListProjects (new) Link ¶

Lists Amazon DataZone projects.

See also: AWS API Documentation

Request Syntax

client.list_projects(
    domainIdentifier='string',
    groupIdentifier='string',
    maxResults=123,
    name='string',
    nextToken='string',
    userIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type groupIdentifier

string

param groupIdentifier

The identifier of a group.

type maxResults

integer

param maxResults

The maximum number of projects to return in a single call to ListProjects . When the number of projects to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListProjects to list the next set of projects.

type name

string

param name

type nextToken

string

param nextToken

When the number of projects is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of projects, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListProjects to list the next set of projects.

type userIdentifier

string

param userIdentifier

The identifier of the Amazon DataZone user.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'description': 'string',
            'domainId': 'string',
            'id': 'string',
            'name': 'string',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListProjects action.

      • (dict) --

        The details of a Amazon DataZone project.

        • createdAt (datetime) --

          The timestamp of when a project was created.

        • createdBy (string) --

          The Amazon DataZone user who created the project.

        • description (string) --

          The description of a project.

        • domainId (string) --

          The identifier of a Amazon DataZone domain where the project exists.

        • id (string) --

          The identifier of a project.

        • name (string) --

          The name of a project.

        • updatedAt (datetime) --

          The timestamp of when the project was updated.

    • nextToken (string) --

      When the number of projects is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of projects, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListProjects to list the next set of projects.

GetProject (new) Link ¶

Gets a project in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_project(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

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

type identifier

string

param identifier

[REQUIRED]

The ID of the project.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'lastUpdatedAt': datetime(2015, 1, 1),
    'name': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the project was created.

    • createdBy (string) --

      The Amazon DataZone user who created the project.

    • description (string) --

      The description of the project.

    • domainId (string) --

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

    • glossaryTerms (list) --

      The business glossary terms that can be used in the project.

      • (string) --

    • id (string) --

      >The ID of the project.

    • lastUpdatedAt (datetime) --

      The timestamp of when the project was last updated.

    • name (string) --

      The name of the project.

DeleteEnvironmentBlueprintConfiguration (new) Link ¶

Deletes the blueprint configuration in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_environment_blueprint_configuration(
    domainIdentifier='string',
    environmentBlueprintIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the blueprint configuration is deleted.

type environmentBlueprintIdentifier

string

param environmentBlueprintIdentifier

[REQUIRED]

The ID of the blueprint the configuration of which is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

UpdateUserProfile (new) Link ¶

Updates the specified user profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_user_profile(
    domainIdentifier='string',
    status='ASSIGNED'|'NOT_ASSIGNED'|'ACTIVATED'|'DEACTIVATED',
    type='IAM'|'SSO',
    userIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a user profile is updated.

type status

string

param status

[REQUIRED]

The status of the user profile that are to be updated.

type type

string

param type

The type of the user profile that are to be updated.

type userIdentifier

string

param userIdentifier

[REQUIRED]

The identifier of the user whose user profile is to be updated.

rtype

dict

returns

Response Syntax

{
    'details': {
        'iam': {
            'arn': 'string'
        },
        'sso': {
            'firstName': 'string',
            'lastName': 'string',
            'username': 'string'
        }
    },
    'domainId': 'string',
    'id': 'string',
    'status': 'ASSIGNED'|'NOT_ASSIGNED'|'ACTIVATED'|'DEACTIVATED',
    'type': 'IAM'|'SSO'
}

Response Structure

  • (dict) --

    • details (dict) --

      The details of the user profile in Amazon DataZone.

      • iam (dict) --

        The IAM details included in the user profile details.

        • arn (string) --

          The ARN of an IAM user profile in Amazon DataZone.

      • sso (dict) --

        The single sign-on details included in the user profile details.

        • firstName (string) --

          The first name included in the single sign-on details of the user profile.

        • lastName (string) --

          The last name included in the single sign-on details of the user profile.

        • username (string) --

          The username included in the single sign-on details of the user profile.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a user profile is updated.

    • id (string) --

      The identifier of the user profile.

    • status (string) --

      The status of the user profile.

    • type (string) --

      The type of the user profile.

RejectSubscriptionRequest (new) Link ¶

Rejects the specified subscription request.

See also: AWS API Documentation

Request Syntax

client.reject_subscription_request(
    decisionComment='string',
    domainIdentifier='string',
    identifier='string'
)
type decisionComment

string

param decisionComment

The decision comment of the rejected subscription request.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which the subscription request was rejected.

type identifier

string

param identifier

[REQUIRED]

The identifier of the subscription request that was rejected.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'decisionComment': 'string',
    'domainId': 'string',
    'id': 'string',
    'requestReason': 'string',
    'reviewerId': 'string',
    'status': 'PENDING'|'ACCEPTED'|'REJECTED',
    'subscribedListings': [
        {
            'description': 'string',
            'id': 'string',
            'item': {
                'assetListing': {
                    'entityId': 'string',
                    'entityRevision': 'string',
                    'entityType': 'string',
                    'forms': 'string',
                    'glossaryTerms': [
                        {
                            'name': 'string',
                            'shortDescription': 'string'
                        },
                    ]
                }
            },
            'name': 'string',
            'ownerProjectId': 'string',
            'ownerProjectName': 'string',
            'revision': 'string'
        },
    ],
    'subscribedPrincipals': [
        {
            'project': {
                'id': 'string',
                'name': 'string'
            }
        },
    ],
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the subscription request was rejected.

    • createdBy (string) --

      The timestamp of when the subscription request was rejected.

    • decisionComment (string) --

      The decision comment of the rejected subscription request.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which the subscription request was rejected.

    • id (string) --

      The identifier of the subscription request that was rejected.

    • requestReason (string) --

      The reason for the subscription request.

    • reviewerId (string) --

      The identifier of the subscription request reviewer.

    • status (string) --

      The status of the subscription request.

    • subscribedListings (list) --

      The subscribed listings of the subscription request.

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

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

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

    • subscribedPrincipals (list) --

      The subscribed principals of the subscription request.

      • (dict) --

        The principal that has the subscription grant for the asset.

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

    • updatedAt (datetime) --

      The timestamp of when the subscription request was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription request.

UpdateGlossaryTerm (new) Link ¶

Updates a business glossary term in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_glossary_term(
    domainIdentifier='string',
    glossaryIdentifier='string',
    identifier='string',
    longDescription='string',
    name='string',
    shortDescription='string',
    status='ENABLED'|'DISABLED',
    termRelations={
        'classifies': [
            'string',
        ],
        'isA': [
            'string',
        ]
    }
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a business glossary term is to be updated.

type glossaryIdentifier

string

param glossaryIdentifier

The identifier of the business glossary in which a term is to be updated.

type identifier

string

param identifier

[REQUIRED]

The identifier of the business glossary term that is to be updated.

type longDescription

string

param longDescription

The long description to be updated as part of the UpdateGlossaryTerm action.

type name

string

param name

The name to be updated as part of the UpdateGlossaryTerm action.

type shortDescription

string

param shortDescription

The short description to be updated as part of the UpdateGlossaryTerm action.

type status

string

param status

The status to be updated as part of the UpdateGlossaryTerm action.

type termRelations

dict

param termRelations

The term relations to be updated as part of the UpdateGlossaryTerm action.

  • classifies (list) --

    The classifies of the term relations.

    • (string) --

  • isA (list) --

    The isA property of the term relations.

    • (string) --

rtype

dict

returns

Response Syntax

{
    'domainId': 'string',
    'glossaryId': 'string',
    'id': 'string',
    'longDescription': 'string',
    'name': 'string',
    'shortDescription': 'string',
    'status': 'ENABLED'|'DISABLED',
    'termRelations': {
        'classifies': [
            'string',
        ],
        'isA': [
            'string',
        ]
    }
}

Response Structure

  • (dict) --

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a business glossary term is to be updated.

    • glossaryId (string) --

      The identifier of the business glossary in which a term is to be updated.

    • id (string) --

      The identifier of the business glossary term that is to be updated.

    • longDescription (string) --

      The long description to be updated as part of the UpdateGlossaryTerm action.

    • name (string) --

      The name to be updated as part of the UpdateGlossaryTerm action.

    • shortDescription (string) --

      The short description to be updated as part of the UpdateGlossaryTerm action.

    • status (string) --

      The status to be updated as part of the UpdateGlossaryTerm action.

    • termRelations (dict) --

      The term relations to be updated as part of the UpdateGlossaryTerm action.

      • classifies (list) --

        The classifies of the term relations.

        • (string) --

      • isA (list) --

        The isA property of the term relations.

        • (string) --

CreateDomain (new) Link ¶

Creates an Amazon DataZone domain.

See also: AWS API Documentation

Request Syntax

client.create_domain(
    clientToken='string',
    description='string',
    domainExecutionRole='string',
    kmsKeyIdentifier='string',
    name='string',
    singleSignOn={
        'type': 'IAM_IDC'|'DISABLED',
        'userAssignment': 'AUTOMATIC'|'MANUAL'
    },
    tags={
        'string': 'string'
    }
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type description

string

param description

The description of the Amazon DataZone domain.

type domainExecutionRole

string

param domainExecutionRole

[REQUIRED]

The domain execution role that is created when an Amazon DataZone domain is created. The domain execution role is created in the Amazon Web Services account that houses the Amazon DataZone domain.

type kmsKeyIdentifier

string

param kmsKeyIdentifier

The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.

type name

string

param name

[REQUIRED]

The name of the Amazon DataZone domain.

type singleSignOn

dict

param singleSignOn

The single-sign on configuration of the Amazon DataZone domain.

  • type (string) --

    The type of single sign-on in Amazon DataZone.

  • userAssignment (string) --

    The single sign-on user assignment in Amazon DataZone.

type tags

dict

param tags

The tags specified for the Amazon DataZone domain.

  • (string) --

    • (string) --

rtype

dict

returns

Response Syntax

{
    'arn': 'string',
    'description': 'string',
    'domainExecutionRole': 'string',
    'id': 'string',
    'kmsKeyIdentifier': 'string',
    'name': 'string',
    'portalUrl': 'string',
    'singleSignOn': {
        'type': 'IAM_IDC'|'DISABLED',
        'userAssignment': 'AUTOMATIC'|'MANUAL'
    },
    'status': 'CREATING'|'AVAILABLE'|'CREATION_FAILED'|'DELETING'|'DELETED'|'DELETION_FAILED',
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • arn (string) --

      The ARN of the Amazon DataZone domain.

    • description (string) --

      The description of the Amazon DataZone domain.

    • domainExecutionRole (string) --

      The domain execution role that is created when an Amazon DataZone domain is created. The domain execution role is created in the Amazon Web Services account that houses the Amazon DataZone domain.

    • id (string) --

      The identifier of the Amazon DataZone domain.

    • kmsKeyIdentifier (string) --

      The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.

    • name (string) --

      The name of the Amazon DataZone domain.

    • portalUrl (string) --

      The URL of the data portal for this Amazon DataZone domain.

    • singleSignOn (dict) --

      The single-sign on configuration of the Amazon DataZone domain.

      • type (string) --

        The type of single sign-on in Amazon DataZone.

      • userAssignment (string) --

        The single sign-on user assignment in Amazon DataZone.

    • status (string) --

      The status of the Amazon DataZone domain.

    • tags (dict) --

      The tags specified for the Amazon DataZone domain.

      • (string) --

        • (string) --

DeleteProject (new) Link ¶

Deletes a project in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_project(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the project is deleted.

type identifier

string

param identifier

[REQUIRED]

The identifier of the project that is to be deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

ListDomains (new) Link ¶

Lists Amazon DataZone domains.

See also: AWS API Documentation

Request Syntax

client.list_domains(
    maxResults=123,
    nextToken='string',
    status='CREATING'|'AVAILABLE'|'CREATION_FAILED'|'DELETING'|'DELETED'|'DELETION_FAILED'
)
type maxResults

integer

param maxResults

The maximum number of domains to return in a single call to ListDomains . When the number of domains to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to ListDomains to list the next set of domains.

type nextToken

string

param nextToken

When the number of domains is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of domains, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDomains to list the next set of domains.

type status

string

param status

The status of the data source.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'description': 'string',
            'id': 'string',
            'lastUpdatedAt': datetime(2015, 1, 1),
            'managedAccountId': 'string',
            'name': 'string',
            'portalUrl': 'string',
            'status': 'CREATING'|'AVAILABLE'|'CREATION_FAILED'|'DELETING'|'DELETED'|'DELETION_FAILED'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the ListDomains action.

      • (dict) --

        A summary of a Amazon DataZone domain.

        • arn (string) --

          The ARN of the Amazon DataZone domain.

        • createdAt (datetime) --

          A timestamp of when a Amazon DataZone domain was created.

        • description (string) --

          A description of an Amazon DataZone domain.

        • id (string) --

          The ID of the Amazon DataZone domain.

        • lastUpdatedAt (datetime) --

          A timestamp of when a Amazon DataZone domain was last updated.

        • managedAccountId (string) --

          The identifier of the Amazon Web Services account that manages the domain.

        • name (string) --

          A name of an Amazon DataZone domain.

        • portalUrl (string) --

          The data portal URL for the Amazon DataZone domain.

        • status (string) --

          The status of the Amazon DataZone domain.

    • nextToken (string) --

      When the number of domains is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of domains, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to ListDomains to list the next set of domains.

GetAsset (new) Link ¶

Gets an Amazon DataZone asset.

See also: AWS API Documentation

Request Syntax

client.get_asset(
    domainIdentifier='string',
    identifier='string',
    revision='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain to which the asset belongs.

type identifier

string

param identifier

[REQUIRED]

The ID of the Amazon DataZone asset.

type revision

string

param revision

The revision of the Amazon DataZone asset.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'externalIdentifier': 'string',
    'firstRevisionCreatedAt': datetime(2015, 1, 1),
    'firstRevisionCreatedBy': 'string',
    'formsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'listing': {
        'listingId': 'string',
        'listingStatus': 'CREATING'|'ACTIVE'|'INACTIVE'
    },
    'name': 'string',
    'owningProjectId': 'string',
    'readOnlyFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'revision': 'string',
    'typeIdentifier': 'string',
    'typeRevision': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the asset was created.

    • createdBy (string) --

      The Amazon DataZone user who created the asset.

    • description (string) --

      The description of the Amazon DataZone asset.

    • domainId (string) --

      The ID of the Amazon DataZone domain to which the asset belongs.

    • externalIdentifier (string) --

    • firstRevisionCreatedAt (datetime) --

      The timestamp of when the first revision of the asset was created.

    • firstRevisionCreatedBy (string) --

      The Amazon DataZone user who created the first revision of the asset.

    • formsOutput (list) --

      The metadata forms attached to the asset.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • glossaryTerms (list) --

      The business glossary terms attached to the asset.

      • (string) --

    • id (string) --

      The ID of the asset.

    • listing (dict) --

      • listingId (string) --

        The identifier of an asset published in an Amazon DataZone catalog.

      • listingStatus (string) --

        The status of an asset published in an Amazon DataZone catalog.

    • name (string) --

      The name of the asset.

    • owningProjectId (string) --

      The ID of the project that owns the asset.

    • readOnlyFormsOutput (list) --

      The read-only metadata forms attached to the asset.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • revision (string) --

      The revision of the asset.

    • typeIdentifier (string) --

      The ID of the asset type.

    • typeRevision (string) --

      The revision of the asset type.

DeleteSubscriptionRequest (new) Link ¶

Deletes a subscription request in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_subscription_request(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the subscription request is deleted.

type identifier

string

param identifier

[REQUIRED]

The ID of the subscription request that is deleted.

returns

None

UpdateSubscriptionGrantStatus (new) Link ¶

Updates the status of the specified subscription grant status in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.update_subscription_grant_status(
    assetIdentifier='string',
    domainIdentifier='string',
    failureCause={
        'message': 'string'
    },
    identifier='string',
    status='GRANT_PENDING'|'REVOKE_PENDING'|'GRANT_IN_PROGRESS'|'REVOKE_IN_PROGRESS'|'GRANTED'|'REVOKED'|'GRANT_FAILED'|'REVOKE_FAILED',
    targetName='string'
)
type assetIdentifier

string

param assetIdentifier

[REQUIRED]

The identifier of the asset the subscription grant status of which is to be updated.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which a subscription grant status is to be updated.

type failureCause

dict

param failureCause

Specifies the error message that is returned if the operation cannot be successfully completed.

  • message (string) --

    The description of the error message.

type identifier

string

param identifier

[REQUIRED]

The identifier of the subscription grant the status of which is to be updated.

type status

string

param status

[REQUIRED]

The status to be updated as part of the UpdateSubscriptionGrantStatus action.

type targetName

string

param targetName

The target name to be updated as part of the UpdateSubscriptionGrantStatus action.

rtype

dict

returns

Response Syntax

{
    'assets': [
        {
            'assetId': 'string',
            'assetRevision': 'string',
            'failureCause': {
                'message': 'string'
            },
            'failureTimestamp': datetime(2015, 1, 1),
            'grantedTimestamp': datetime(2015, 1, 1),
            'status': 'GRANT_PENDING'|'REVOKE_PENDING'|'GRANT_IN_PROGRESS'|'REVOKE_IN_PROGRESS'|'GRANTED'|'REVOKED'|'GRANT_FAILED'|'REVOKE_FAILED',
            'targetName': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'grantedEntity': {
        'listing': {
            'id': 'string',
            'revision': 'string'
        }
    },
    'id': 'string',
    'status': 'PENDING'|'IN_PROGRESS'|'GRANT_FAILED'|'REVOKE_FAILED'|'GRANT_AND_REVOKE_FAILED'|'COMPLETED'|'INACCESSIBLE',
    'subscriptionId': 'string',
    'subscriptionTargetId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • assets (list) --

      • (dict) --

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

        • assetId (string) --

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

        • assetRevision (string) --

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

        • failureCause (dict) --

          The failure cause included in the details of the asset for which the subscription grant is created.

          • message (string) --

            The description of the error message.

        • failureTimestamp (datetime) --

          The failure timestamp included in the details of the asset for which the subscription grant is created.

        • grantedTimestamp (datetime) --

          The timestamp of when the subscription grant to the asset is created.

        • status (string) --

          The status of the asset for which the subscription grant is created.

        • targetName (string) --

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

    • createdAt (datetime) --

      The timestamp of when the subscription grant status was created.

    • createdBy (string) --

      The Amazon DataZone domain user who created the subscription grant status.

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which a subscription grant status is to be updated.

    • grantedEntity (dict) --

      The granted entity to be updated as part of the UpdateSubscriptionGrantStatus action.

      • listing (dict) --

        The listing for which a subscription is granted.

        • id (string) --

          An identifier of a revision of an asset published in a Amazon DataZone catalog.

        • revision (string) --

          The details of a revision of an asset published in a Amazon DataZone catalog.

    • id (string) --

      The identifier of the subscription grant.

    • status (string) --

      The status to be updated as part of the UpdateSubscriptionGrantStatus action.

    • subscriptionId (string) --

      The identifier of the subscription.

    • subscriptionTargetId (string) --

      The identifier of the subscription target whose subscription grant status is to be updated.

    • updatedAt (datetime) --

      The timestamp of when the subscription grant status is to be updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription grant status.

CreateSubscriptionRequest (new) Link ¶

Creates a subscription request in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.create_subscription_request(
    clientToken='string',
    domainIdentifier='string',
    requestReason='string',
    subscribedListings=[
        {
            'identifier': 'string'
        },
    ],
    subscribedPrincipals=[
        {
            'project': {
                'identifier': 'string'
            }
        },
    ]
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the subscription request is created.

type requestReason

string

param requestReason

[REQUIRED]

The reason for the subscription request.

type subscribedListings

list

param subscribedListings

[REQUIRED]

  • (dict) --

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

    • identifier (string) -- [REQUIRED]

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

type subscribedPrincipals

list

param subscribedPrincipals

[REQUIRED]

The Amazon DataZone principals for whom the subscription request is created.

  • (dict) --

    The principal that is to be given a subscriptiong grant.

    • project (dict) --

      The project that is to be given a subscription grant.

      • identifier (string) --

        The identifier of the project that is to be given a subscription grant.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'decisionComment': 'string',
    'domainId': 'string',
    'id': 'string',
    'requestReason': 'string',
    'reviewerId': 'string',
    'status': 'PENDING'|'ACCEPTED'|'REJECTED',
    'subscribedListings': [
        {
            'description': 'string',
            'id': 'string',
            'item': {
                'assetListing': {
                    'entityId': 'string',
                    'entityRevision': 'string',
                    'entityType': 'string',
                    'forms': 'string',
                    'glossaryTerms': [
                        {
                            'name': 'string',
                            'shortDescription': 'string'
                        },
                    ]
                }
            },
            'name': 'string',
            'ownerProjectId': 'string',
            'ownerProjectName': 'string',
            'revision': 'string'
        },
    ],
    'subscribedPrincipals': [
        {
            'project': {
                'id': 'string',
                'name': 'string'
            }
        },
    ],
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      A timestamp of when the subscription request is created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription request.

    • decisionComment (string) --

      The decision comment of the subscription request.

    • domainId (string) --

      The ID of the Amazon DataZone domain in whcih the subscription request is created.

    • id (string) --

      The ID of the subscription request.

    • requestReason (string) --

      The reason for the subscription request.

    • reviewerId (string) --

      The ID of the reviewer of the subscription request.

    • status (string) --

      The status of the subscription request.

    • subscribedListings (list) --

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

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

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

    • subscribedPrincipals (list) --

      The subscribed principals of the subscription request.

      • (dict) --

        The principal that has the subscription grant for the asset.

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

    • updatedAt (datetime) --

      The timestamp of when the subscription request was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription request.

SearchTypes (new) Link ¶

Searches for types in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.search_types(
    domainIdentifier='string',
    filters={
        'and': [
            {'... recursive ...'},
        ],
        'filter': {
            'attribute': 'string',
            'value': 'string'
        },
        'or': [
            {'... recursive ...'},
        ]
    },
    managed=True|False,
    maxResults=123,
    nextToken='string',
    searchIn=[
        {
            'attribute': 'string'
        },
    ],
    searchScope='ASSET_TYPE'|'FORM_TYPE',
    searchText='string',
    sort={
        'attribute': 'string',
        'order': 'ASCENDING'|'DESCENDING'
    }
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which to invoke the SearchTypes action.

type filters

dict

param filters

The filters for the SearchTypes action.

  • and (list) --

    The 'and' search filter clause in Amazon DataZone.

    • (dict) --

      A search filter clause in Amazon DataZone.

  • filter (dict) --

    A search filter in Amazon DataZone.

    • attribute (string) -- [REQUIRED]

      A search filter attribute in Amazon DataZone.

    • value (string) -- [REQUIRED]

      A search filter value in Amazon DataZone.

  • or (list) --

    The 'or' search filter clause in Amazon DataZone.

    • (dict) --

      A search filter clause in Amazon DataZone.

type managed

boolean

param managed

[REQUIRED]

type maxResults

integer

param maxResults

The maximum number of results to return in a single call to SearchTypes . When the number of results to be listed is greater than the value of MaxResults , the response contains a NextToken value that you can use in a subsequent call to SearchTypes to list the next set of results.

type nextToken

string

param nextToken

When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchTypes to list the next set of results.

type searchIn

list

param searchIn
  • (dict) --

    The details of the search.

    • attribute (string) -- [REQUIRED]

      The search attribute.

type searchScope

string

param searchScope

[REQUIRED]

Specifies the scope of the search for types.

type searchText

string

param searchText

Specifies the text for which to search.

type sort

dict

param sort

The specifies the way to sort the SearchTypes results.

  • attribute (string) -- [REQUIRED]

    The attribute detail of the way to sort search results.

  • order (string) --

    The order detail of the wya to sort search results.

rtype

dict

returns

Response Syntax

{
    'items': [
        {
            'assetTypeItem': {
                'createdAt': datetime(2015, 1, 1),
                'createdBy': 'string',
                'description': 'string',
                'domainId': 'string',
                'formsOutput': {
                    'string': {
                        'required': True|False,
                        'typeName': 'string',
                        'typeRevision': 'string'
                    }
                },
                'name': 'string',
                'originDomainId': 'string',
                'originProjectId': 'string',
                'owningProjectId': 'string',
                'revision': 'string',
                'updatedAt': datetime(2015, 1, 1),
                'updatedBy': 'string'
            },
            'formTypeItem': {
                'createdAt': datetime(2015, 1, 1),
                'createdBy': 'string',
                'description': 'string',
                'domainId': 'string',
                'imports': [
                    {
                        'name': 'string',
                        'revision': 'string'
                    },
                ],
                'model': {
                    'smithy': 'string'
                },
                'name': 'string',
                'originDomainId': 'string',
                'originProjectId': 'string',
                'owningProjectId': 'string',
                'revision': 'string',
                'status': 'ENABLED'|'DISABLED'
            }
        },
    ],
    'nextToken': 'string',
    'totalMatchCount': 123
}

Response Structure

  • (dict) --

    • items (list) --

      The results of the SearchTypes action.

      • (dict) --

        The details of the results of the SearchTypes action.

        • assetTypeItem (dict) --

          The asset type included in the results of the SearchTypes action.

          • createdAt (datetime) --

            The timestamp of when the asset type was created.

          • createdBy (string) --

            The Amazon DataZone user who created the asset type.

          • description (string) --

            The description of the asset type.

          • domainId (string) --

            The identifier of the Amazon DataZone domain where the asset type exists.

          • formsOutput (dict) --

            The forms included in the details of the asset type.

            • (string) --

              • (dict) --

                The details of the form entry.

                • required (boolean) --

                  Specifies whether a form entry is required.

                • typeName (string) --

                  The name of the type of the form entry.

                • typeRevision (string) --

                  The type revision of the form entry.

          • name (string) --

            The name of the asset type.

          • originDomainId (string) --

            The identifier of the Amazon DataZone domain where the asset type was originally created.

          • originProjectId (string) --

            The identifier of the Amazon DataZone project where the asset type exists.

          • owningProjectId (string) --

            The identifier of the Amazon DataZone project that owns the asset type.

          • revision (string) --

            The revision of the asset type.

          • updatedAt (datetime) --

            The timestamp of when the asset type was updated.

          • updatedBy (string) --

            The Amazon DataZone user who updated the asset type.

        • formTypeItem (dict) --

          The form type included in the results of the SearchTypes action.

          • createdAt (datetime) --

            The timestamp of when the metadata form type was created.

          • createdBy (string) --

            The Amazon DataZone user who created teh metadata form type.

          • description (string) --

            The description of the metadata form type.

          • domainId (string) --

            The identifier of the Amazon DataZone domain in which the form type exists.

          • imports (list) --

            The imports specified in the form type.

            • (dict) --

              The details of the import of the metadata form type.

              • name (string) --

                The name of the import.

              • revision (string) --

                The revision of the import.

          • model (dict) --

            The model of the form type.

            • smithy (string) --

          • name (string) --

            The name of the form type.

          • originDomainId (string) --

            The identifier of the Amazon DataZone domain in which the form type was originally created.

          • originProjectId (string) --

            The identifier of the project in which the form type was originally created.

          • owningProjectId (string) --

            The identifier of the project that owns the form type.

          • revision (string) --

            The revision of the form type.

          • status (string) --

            The status of the form type.

    • nextToken (string) --

      When the number of results is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of results, the response includes a pagination token named NextToken . You can specify this NextToken value in a subsequent call to SearchTypes to list the next set of results.

    • totalMatchCount (integer) --

      Total number of search results.

CreateAsset (new) Link ¶

Creates an asset in Amazon DataZone catalog.

See also: AWS API Documentation

Request Syntax

client.create_asset(
    clientToken='string',
    description='string',
    domainIdentifier='string',
    externalIdentifier='string',
    formsInput=[
        {
            'content': 'string',
            'formName': 'string',
            'typeIdentifier': 'string',
            'typeRevision': 'string'
        },
    ],
    glossaryTerms=[
        'string',
    ],
    name='string',
    owningProjectIdentifier='string',
    predictionConfiguration={
        'businessNameGeneration': {
            'enabled': True|False
        }
    },
    typeIdentifier='string',
    typeRevision='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type description

string

param description

Asset description.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

Amazon DataZone domain where the asset is created.

type externalIdentifier

string

param externalIdentifier

type formsInput

list

param formsInput

Metadata forms attached to the asset.

  • (dict) --

    The details of a metadata form.

    • content (string) --

      The content of the metadata form.

    • formName (string) -- [REQUIRED]

      The name of the metadata form.

    • typeIdentifier (string) --

      The ID of the metadata form type.

    • typeRevision (string) --

      The revision of the metadata form type.

type glossaryTerms

list

param glossaryTerms

Glossary terms attached to the asset.

  • (string) --

type name

string

param name

[REQUIRED]

Asset name.

type owningProjectIdentifier

string

param owningProjectIdentifier

[REQUIRED]

The unique identifier of the project that owns this asset.

type predictionConfiguration

dict

param predictionConfiguration

The configuration of the automatically generated business-friendly metadata for the asset.

  • businessNameGeneration (dict) --

    The business name generation mechanism.

    • enabled (boolean) --

      Specifies whether the business name generation is enabled.

type typeIdentifier

string

param typeIdentifier

[REQUIRED]

The unique identifier of this asset's type.

type typeRevision

string

param typeRevision

The revision of this asset's type.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'description': 'string',
    'domainId': 'string',
    'externalIdentifier': 'string',
    'firstRevisionCreatedAt': datetime(2015, 1, 1),
    'firstRevisionCreatedBy': 'string',
    'formsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'id': 'string',
    'listing': {
        'listingId': 'string',
        'listingStatus': 'CREATING'|'ACTIVE'|'INACTIVE'
    },
    'name': 'string',
    'owningProjectId': 'string',
    'predictionConfiguration': {
        'businessNameGeneration': {
            'enabled': True|False
        }
    },
    'readOnlyFormsOutput': [
        {
            'content': 'string',
            'formName': 'string',
            'typeName': 'string',
            'typeRevision': 'string'
        },
    ],
    'revision': 'string',
    'typeIdentifier': 'string',
    'typeRevision': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the asset was created.

    • createdBy (string) --

      The Amazon DataZone user that created this asset in the catalog.

    • description (string) --

      The description of the created asset.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the asset was created.

    • externalIdentifier (string) --

    • firstRevisionCreatedAt (datetime) --

      The timestamp of when the first revision of the asset took place.

    • firstRevisionCreatedBy (string) --

      The Amazon DataZone user that made the first revision of the asset.

    • formsOutput (list) --

      The metadata forms that are attached to the created asset.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • glossaryTerms (list) --

      The glossary terms that are attached to the created asset.

      • (string) --

    • id (string) --

      The unique identifier of the created asset.

    • listing (dict) --

      • listingId (string) --

        The identifier of an asset published in an Amazon DataZone catalog.

      • listingStatus (string) --

        The status of an asset published in an Amazon DataZone catalog.

    • name (string) --

      The name of the created asset.

    • owningProjectId (string) --

      The ID of the Amazon DataZone project that owns the created asset.

    • predictionConfiguration (dict) --

      The configuration of the automatically generated business-friendly metadata for the asset.

      • businessNameGeneration (dict) --

        The business name generation mechanism.

        • enabled (boolean) --

          Specifies whether the business name generation is enabled.

    • readOnlyFormsOutput (list) --

      The read-only metadata forms that are attached to the created asset.

      • (dict) --

        The details of a metadata form.

        • content (string) --

          The content of the metadata form.

        • formName (string) --

          The name of the metadata form.

        • typeName (string) --

          The name of the metadata form type.

        • typeRevision (string) --

          The revision of the metadata form type.

    • revision (string) --

      The revision of the asset.

    • typeIdentifier (string) --

      The identifier of the created asset type.

    • typeRevision (string) --

      The revision type of the asset.

CreateSubscriptionTarget (new) Link ¶

Creates a subscription target in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.create_subscription_target(
    applicableAssetTypes=[
        'string',
    ],
    authorizedPrincipals=[
        'string',
    ],
    clientToken='string',
    domainIdentifier='string',
    environmentIdentifier='string',
    manageAccessRole='string',
    name='string',
    provider='string',
    subscriptionTargetConfig=[
        {
            'content': 'string',
            'formName': 'string'
        },
    ],
    type='string'
)
type applicableAssetTypes

list

param applicableAssetTypes

[REQUIRED]

The asset types that can be included in the subscription target.

  • (string) --

type authorizedPrincipals

list

param authorizedPrincipals

[REQUIRED]

The authorized principals of the subscription target.

  • (string) --

type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which subscription target is created.

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The ID of the environment in which subscription target is created.

type manageAccessRole

string

param manageAccessRole

[REQUIRED]

The manage access role that is used to create the subscription target.

type name

string

param name

[REQUIRED]

The name of the subscription target.

type provider

string

param provider

The provider of the subscription target.

type subscriptionTargetConfig

list

param subscriptionTargetConfig

[REQUIRED]

The configuration of the subscription target.

  • (dict) --

    The details of the subscription target configuration.

    • content (string) -- [REQUIRED]

      The content of the subscription target configuration.

    • formName (string) -- [REQUIRED]

      The form name included in the subscription target configuration.

type type

string

param type

[REQUIRED]

The type of the subscription target.

rtype

dict

returns

Response Syntax

{
    'applicableAssetTypes': [
        'string',
    ],
    'authorizedPrincipals': [
        'string',
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'environmentId': 'string',
    'id': 'string',
    'manageAccessRole': 'string',
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'subscriptionTargetConfig': [
        {
            'content': 'string',
            'formName': 'string'
        },
    ],
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • applicableAssetTypes (list) --

      The asset types that can be included in the subscription target.

      • (string) --

    • authorizedPrincipals (list) --

      The authorised principals of the subscription target.

      • (string) --

    • createdAt (datetime) --

      The timestamp of when the subscription target was created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription target.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the subscription target was created.

    • environmentId (string) --

      The ID of the environment in which the subscription target was created.

    • id (string) --

      The ID of the subscription target.

    • manageAccessRole (string) --

      The manage access role with which the subscription target was created.

    • name (string) --

      The name of the subscription target.

    • projectId (string) --

      ???

    • provider (string) --

      The provider of the subscription target.

    • subscriptionTargetConfig (list) --

      The configuration of the subscription target.

      • (dict) --

        The details of the subscription target configuration.

        • content (string) --

          The content of the subscription target configuration.

        • formName (string) --

          The form name included in the subscription target configuration.

    • type (string) --

      The type of the subscription target.

    • updatedAt (datetime) --

      The timestamp of when the subscription target was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription target.

DeleteFormType (new) Link ¶

Delets and metadata form type in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_form_type(
    domainIdentifier='string',
    formTypeIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the metadata form type is deleted.

type formTypeIdentifier

string

param formTypeIdentifier

[REQUIRED]

The ID of the metadata form type that is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

CreateGroupProfile (new) Link ¶

Creates a group profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.create_group_profile(
    clientToken='string',
    domainIdentifier='string',
    groupIdentifier='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain in which the group profile is created.

type groupIdentifier

string

param groupIdentifier

[REQUIRED]

The identifier of the group for which the group profile is created.

rtype

dict

returns

Response Syntax

{
    'domainId': 'string',
    'groupName': 'string',
    'id': 'string',
    'status': 'ASSIGNED'|'NOT_ASSIGNED'
}

Response Structure

  • (dict) --

    • domainId (string) --

      The identifier of the Amazon DataZone domain in which the group profile is created.

    • groupName (string) --

      The name of the group for which group profile is created.

    • id (string) --

      The identifier of the group profile.

    • status (string) --

      The status of the group profile.

CreateSubscriptionGrant (new) Link ¶

Creates a subsscription grant in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.create_subscription_grant(
    assetTargetNames=[
        {
            'assetId': 'string',
            'targetName': 'string'
        },
    ],
    clientToken='string',
    domainIdentifier='string',
    environmentIdentifier='string',
    grantedEntity={
        'listing': {
            'identifier': 'string',
            'revision': 'string'
        }
    },
    subscriptionTargetIdentifier='string'
)
type assetTargetNames

list

param assetTargetNames

The names of the assets for which the subscription grant is created.

  • (dict) --

    • assetId (string) -- [REQUIRED]

      The identifier of the inventory asset.

    • targetName (string) -- [REQUIRED]

      The target name in the asset target name map.

type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the subscription grant is created.

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The ID of the environment in which the subscription grant is created.

type grantedEntity

dict

param grantedEntity

[REQUIRED]

The entity to which the subscription is to be granted.

  • listing (dict) --

    The listing for which a subscription is to be granted.

    • identifier (string) -- [REQUIRED]

      An identifier of revision to be made to an asset published in a Amazon DataZone catalog.

    • revision (string) -- [REQUIRED]

      The details of a revision to be made to an asset published in a Amazon DataZone catalog.

type subscriptionTargetIdentifier

string

param subscriptionTargetIdentifier

[REQUIRED]

The ID of the subscription target for which the subscription grant is created.

rtype

dict

returns

Response Syntax

{
    'assets': [
        {
            'assetId': 'string',
            'assetRevision': 'string',
            'failureCause': {
                'message': 'string'
            },
            'failureTimestamp': datetime(2015, 1, 1),
            'grantedTimestamp': datetime(2015, 1, 1),
            'status': 'GRANT_PENDING'|'REVOKE_PENDING'|'GRANT_IN_PROGRESS'|'REVOKE_IN_PROGRESS'|'GRANTED'|'REVOKED'|'GRANT_FAILED'|'REVOKE_FAILED',
            'targetName': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'grantedEntity': {
        'listing': {
            'id': 'string',
            'revision': 'string'
        }
    },
    'id': 'string',
    'status': 'PENDING'|'IN_PROGRESS'|'GRANT_FAILED'|'REVOKE_FAILED'|'GRANT_AND_REVOKE_FAILED'|'COMPLETED'|'INACCESSIBLE',
    'subscriptionId': 'string',
    'subscriptionTargetId': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • assets (list) --

      The assets for which the subscription grant is created.

      • (dict) --

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

        • assetId (string) --

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

        • assetRevision (string) --

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

        • failureCause (dict) --

          The failure cause included in the details of the asset for which the subscription grant is created.

          • message (string) --

            The description of the error message.

        • failureTimestamp (datetime) --

          The failure timestamp included in the details of the asset for which the subscription grant is created.

        • grantedTimestamp (datetime) --

          The timestamp of when the subscription grant to the asset is created.

        • status (string) --

          The status of the asset for which the subscription grant is created.

        • targetName (string) --

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

    • createdAt (datetime) --

      A timestamp of when the subscription grant is created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription grant.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which the subscription grant is created.

    • grantedEntity (dict) --

      The entity to which the subscription is granted.

      • listing (dict) --

        The listing for which a subscription is granted.

        • id (string) --

          An identifier of a revision of an asset published in a Amazon DataZone catalog.

        • revision (string) --

          The details of a revision of an asset published in a Amazon DataZone catalog.

    • id (string) --

      The ID of the subscription grant.

    • status (string) --

      The status of the subscription grant.

    • subscriptionId (string) --

      The identifier of the subscription grant.

    • subscriptionTargetId (string) --

      The ID of the subscription target for which the subscription grant is created.

    • updatedAt (datetime) --

      A timestamp of when the subscription grant was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription grant.

GetDomain (new) Link ¶

Gets an Amazon DataZone domain.

See also: AWS API Documentation

Request Syntax

client.get_domain(
    identifier='string'
)
type identifier

string

param identifier

[REQUIRED]

The identifier of the specified Amazon DataZone domain.

rtype

dict

returns

Response Syntax

{
    'arn': 'string',
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'domainExecutionRole': 'string',
    'id': 'string',
    'kmsKeyIdentifier': 'string',
    'lastUpdatedAt': datetime(2015, 1, 1),
    'name': 'string',
    'portalUrl': 'string',
    'singleSignOn': {
        'type': 'IAM_IDC'|'DISABLED',
        'userAssignment': 'AUTOMATIC'|'MANUAL'
    },
    'status': 'CREATING'|'AVAILABLE'|'CREATION_FAILED'|'DELETING'|'DELETED'|'DELETION_FAILED',
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • arn (string) --

      The ARN of the specified Amazon DataZone domain.

    • createdAt (datetime) --

      The timestamp of when the Amazon DataZone domain was created.

    • description (string) --

      The description of the Amazon DataZone domain.

    • domainExecutionRole (string) --

      The domain execution role with which the Amazon DataZone domain is created.

    • id (string) --

      The identifier of the specified Amazon DataZone domain.

    • kmsKeyIdentifier (string) --

      The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.

    • lastUpdatedAt (datetime) --

      The timestamp of when the Amazon DataZone domain was last updated.

    • name (string) --

      The name of the Amazon DataZone domain.

    • portalUrl (string) --

      The URL of the data portal for this Amazon DataZone domain.

    • singleSignOn (dict) --

      The single sing-on option of the specified Amazon DataZone domain.

      • type (string) --

        The type of single sign-on in Amazon DataZone.

      • userAssignment (string) --

        The single sign-on user assignment in Amazon DataZone.

    • status (string) --

      The status of the specified Amazon DataZone domain.

    • tags (dict) --

      The tags specified for the Amazon DataZone domain.

      • (string) --

        • (string) --

DeleteGlossary (new) Link ¶

Deletes a business glossary in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_glossary(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the business glossary is deleted.

type identifier

string

param identifier

[REQUIRED]

The ID of the business glossary that is deleted.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

GetGlossaryTerm (new) Link ¶

Gets a business glossary term in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_glossary_term(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which this business glossary term exists.

type identifier

string

param identifier

[REQUIRED]

The ID of the business glossary term.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'glossaryId': 'string',
    'id': 'string',
    'longDescription': 'string',
    'name': 'string',
    'shortDescription': 'string',
    'status': 'ENABLED'|'DISABLED',
    'termRelations': {
        'classifies': [
            'string',
        ],
        'isA': [
            'string',
        ]
    },
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the business glossary term was created.

    • createdBy (string) --

      The Amazon DataZone user who created the business glossary.

    • domainId (string) --

      The ID of the Amazon DataZone domain in which this business glossary term exists.

    • glossaryId (string) --

      The ID of the business glossary to which this term belongs.

    • id (string) --

      The ID of the business glossary term.

    • longDescription (string) --

      The long description of the business glossary term.

    • name (string) --

      The name of the business glossary term.

    • shortDescription (string) --

      The short decription of the business glossary term.

    • status (string) --

      The status of the business glossary term.

    • termRelations (dict) --

      The relations of the business glossary term.

      • classifies (list) --

        The classifies of the term relations.

        • (string) --

      • isA (list) --

        The isA property of the term relations.

        • (string) --

    • updatedAt (datetime) --

      The timestamp of when the business glossary term was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the business glossary term.

DeleteEnvironmentProfile (new) Link ¶

Deletes an environment profile in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.delete_environment_profile(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the Amazon DataZone domain in which the environment profile is deleted.

type identifier

string

param identifier

[REQUIRED]

The ID of the environment profile that is deleted.

returns

None

GetDataSourceRun (new) Link ¶

Gets an Amazon DataZone data source run.

See also: AWS API Documentation

Request Syntax

client.get_data_source_run(
    domainIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The ID of the domain in which this data source run was performed.

type identifier

string

param identifier

[REQUIRED]

The ID of the data source run.

rtype

dict

returns

Response Syntax

{
    'createdAt': datetime(2015, 1, 1),
    'dataSourceConfigurationSnapshot': 'string',
    'dataSourceId': 'string',
    'domainId': 'string',
    'errorMessage': {
        'errorDetail': 'string',
        'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
    },
    'id': 'string',
    'projectId': 'string',
    'runStatisticsForAssets': {
        'added': 123,
        'failed': 123,
        'skipped': 123,
        'unchanged': 123,
        'updated': 123
    },
    'startedAt': datetime(2015, 1, 1),
    'status': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
    'stoppedAt': datetime(2015, 1, 1),
    'type': 'PRIORITIZED'|'SCHEDULED',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • createdAt (datetime) --

      The timestamp of when the data source run was created.

    • dataSourceConfigurationSnapshot (string) --

      The configuration snapshot of the data source run.

    • dataSourceId (string) --

      The ID of the data source for this data source run.

    • domainId (string) --

      The ID of the domain in which this data source run was performed.

    • errorMessage (dict) --

      Specifies the error message that is returned if the operation cannot be successfully completed.

      • errorDetail (string) --

        The details of the error message that is returned if the operation cannot be successfully completed.

      • errorType (string) --

        The type of the error message that is returned if the operation cannot be successfully completed.

    • id (string) --

      The ID of the data source run.

    • projectId (string) --

      The ID of the project in which this data source run occured.

    • runStatisticsForAssets (dict) --

      The asset statistics from this data source run.

      • added (integer) --

        The added statistic for the data source run.

      • failed (integer) --

        The failed statistic for the data source run.

      • skipped (integer) --

        The skipped statistic for the data source run.

      • unchanged (integer) --

        The unchanged statistic for the data source run.

      • updated (integer) --

        The updated statistic for the data source run.

    • startedAt (datetime) --

      The timestamp of when this data source run started.

    • status (string) --

      The status of this data source run.

    • stoppedAt (datetime) --

      The timestamp of when this data source run stopped.

    • type (string) --

      The type of this data source run.

    • updatedAt (datetime) --

      The timestamp of when this data source run was updated.

GetSubscriptionTarget (new) Link ¶

Gets the subscription target in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.get_subscription_target(
    domainIdentifier='string',
    environmentIdentifier='string',
    identifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

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

type environmentIdentifier

string

param environmentIdentifier

[REQUIRED]

The ID of the environment associated with the subscription target.

type identifier

string

param identifier

[REQUIRED]

The ID of the subscription target.

rtype

dict

returns

Response Syntax

{
    'applicableAssetTypes': [
        'string',
    ],
    'authorizedPrincipals': [
        'string',
    ],
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'domainId': 'string',
    'environmentId': 'string',
    'id': 'string',
    'manageAccessRole': 'string',
    'name': 'string',
    'projectId': 'string',
    'provider': 'string',
    'subscriptionTargetConfig': [
        {
            'content': 'string',
            'formName': 'string'
        },
    ],
    'type': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string'
}

Response Structure

  • (dict) --

    • applicableAssetTypes (list) --

      The asset types associated with the subscription target.

      • (string) --

    • authorizedPrincipals (list) --

      The authorized principals of the subscription target.

      • (string) --

    • createdAt (datetime) --

      The timestamp of when the subscription target was created.

    • createdBy (string) --

      The Amazon DataZone user who created the subscription target.

    • domainId (string) --

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

    • environmentId (string) --

      The ID of the environment associated with the subscription target.

    • id (string) --

      The ID of the subscription target.

    • manageAccessRole (string) --

      The manage access role with which the subscription target was created.

    • name (string) --

      The name of the subscription target.

    • projectId (string) --

      The ID of the project associated with the subscription target.

    • provider (string) --

      The provider of the subscription target.

    • subscriptionTargetConfig (list) --

      The configuration of teh subscription target.

      • (dict) --

        The details of the subscription target configuration.

        • content (string) --

          The content of the subscription target configuration.

        • formName (string) --

          The form name included in the subscription target configuration.

    • type (string) --

      The type of the subscription target.

    • updatedAt (datetime) --

      The timestamp of when the subscription target was updated.

    • updatedBy (string) --

      The Amazon DataZone user who updated the subscription target.

GetIamPortalLoginUrl (new) Link ¶

Gets the data portal URL for the specified Amazon DataZone domain.

See also: AWS API Documentation

Request Syntax

client.get_iam_portal_login_url(
    domainIdentifier='string'
)
type domainIdentifier

string

param domainIdentifier

[REQUIRED]

the ID of the Amazon DataZone domain the data portal of which you want to get.

rtype

dict

returns

Response Syntax

{
    'authCodeUrl': 'string',
    'userProfileId': 'string'
}

Response Structure

  • (dict) --

    • authCodeUrl (string) --

      The data portal URL of the specified Amazon DataZone domain.

    • userProfileId (string) --

      The ID of the user profile.

TagResource (new) Link ¶

Tags a resource in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

client.tag_resource(
    resourceArn='string',
    tags={
        'string': 'string'
    }
)
type resourceArn

string

param resourceArn

[REQUIRED]

The ARN of the resource to be tagged in Amazon DataZone.

type tags

dict

param tags

[REQUIRED]

Specifies the tags for the TagResource action.

  • (string) --

    • (string) --

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

RejectPredictions (new) Link ¶

Rejects automatically generated business-friendly metadata for your Amazon DataZone assets.

See also: AWS API Documentation

Request Syntax

client.reject_predictions(
    clientToken='string',
    domainIdentifier='string',
    identifier='string',
    rejectChoices=[
        {
            'predictionChoices': [
                123,
            ],
            'predictionTarget': 'string'
        },
    ],
    rejectRule={
        'rule': 'ALL'|'NONE',
        'threshold': ...
    },
    revision='string'
)
type clientToken

string

param clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

This field is autopopulated if not provided.

type domainIdentifier

string

param domainIdentifier

[REQUIRED]

The identifier of the Amazon DataZone domain.

type identifier

string

param identifier

[REQUIRED]

The identifier of the prediction.

type rejectChoices

list

param rejectChoices
  • (dict) --

    The details of the automatically generated business metadata that is rejected.

    • predictionChoices (list) --

      Specifies the the automatically generated business metadata that can be rejected.

      • (integer) --

    • predictionTarget (string) --

      Specifies the target (for example, a column name) where a prediction can be rejected.

type rejectRule

dict

param rejectRule
  • rule (string) --

    Specifies whether you want to reject the top prediction for all targets or none.

  • threshold (float) --

    The confidence score that specifies the condition at which a prediction can be rejected.

type revision

string

param revision

rtype

dict

returns

Response Syntax

{
    'assetId': 'string',
    'assetRevision': 'string',
    'domainId': 'string'
}

Response Structure

  • (dict) --

    • assetId (string) --

    • assetRevision (string) --

    • domainId (string) --