SDK for PHP 3.x

Client: Aws\DataZone\DataZoneClient
Service ID: datazone
Version: 2018-05-10

This page describes the parameters and results for the operations of the Amazon DataZone (2018-05-10), and shows how to use the Aws\DataZone\DataZoneClient object to call the described operations. This documentation is specific to the 2018-05-10 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

AcceptPredictions ( array $params = [] )
Accepts automatically generated business-friendly metadata for your Amazon DataZone assets.
AcceptSubscriptionRequest ( array $params = [] )
Accepts a subscription request to a specific asset.
AddEntityOwner ( array $params = [] )
Adds the owner of an entity (a domain unit).
AddPolicyGrant ( array $params = [] )
Adds a policy grant (an authorization policy) to a specified entity, including domain units, environment blueprint configurations, or environment profiles.
AssociateEnvironmentRole ( array $params = [] )
Associates the environment role in Amazon DataZone.
CancelMetadataGenerationRun ( array $params = [] )
Cancels the metadata generation run.
CancelSubscription ( array $params = [] )
Cancels the subscription to the specified asset.
CreateAsset ( array $params = [] )
Creates an asset in Amazon DataZone catalog.
CreateAssetFilter ( array $params = [] )
Creates a data asset filter.
CreateAssetRevision ( array $params = [] )
Creates a revision of the asset.
CreateAssetType ( array $params = [] )
Creates a custom asset type.
CreateConnection ( array $params = [] )
Creates a new connection.
CreateDataProduct ( array $params = [] )
Creates a data product.
CreateDataProductRevision ( array $params = [] )
Creates a data product revision.
CreateDataSource ( array $params = [] )
Creates an Amazon DataZone data source.
CreateDomain ( array $params = [] )
Creates an Amazon DataZone domain.
CreateDomainUnit ( array $params = [] )
Creates a domain unit in Amazon DataZone.
CreateEnvironment ( array $params = [] )
Create an Amazon DataZone environment.
CreateEnvironmentAction ( array $params = [] )
Creates an action for the environment, for example, creates a console link for an analytics tool that is available in this environment.
CreateEnvironmentProfile ( array $params = [] )
Creates an Amazon DataZone environment profile.
CreateFormType ( array $params = [] )
Creates a metadata form type.
CreateGlossary ( array $params = [] )
Creates an Amazon DataZone business glossary.
CreateGlossaryTerm ( array $params = [] )
Creates a business glossary term.
CreateGroupProfile ( array $params = [] )
Creates a group profile in Amazon DataZone.
CreateListingChangeSet ( array $params = [] )
Publishes a listing (a record of an asset at a given time) or removes a listing from the catalog.
CreateProject ( array $params = [] )
Creates an Amazon DataZone project.
CreateProjectMembership ( array $params = [] )
Creates a project membership in Amazon DataZone.
CreateProjectProfile ( array $params = [] )
Creates a project profile.
CreateRule ( array $params = [] )
Creates a rule in Amazon DataZone.
CreateSubscriptionGrant ( array $params = [] )
Creates a subsscription grant in Amazon DataZone.
CreateSubscriptionRequest ( array $params = [] )
Creates a subscription request in Amazon DataZone.
CreateSubscriptionTarget ( array $params = [] )
Creates a subscription target in Amazon DataZone.
CreateUserProfile ( array $params = [] )
Creates a user profile in Amazon DataZone.
DeleteAsset ( array $params = [] )
Deletes an asset in Amazon DataZone.
DeleteAssetFilter ( array $params = [] )
Deletes an asset filter.
DeleteAssetType ( array $params = [] )
Deletes an asset type in Amazon DataZone.
DeleteConnection ( array $params = [] )
Deletes and connection.
DeleteDataProduct ( array $params = [] )
Deletes a data product in Amazon DataZone.
DeleteDataSource ( array $params = [] )
Deletes a data source in Amazon DataZone.
DeleteDomain ( array $params = [] )
Deletes a Amazon DataZone domain.
DeleteDomainUnit ( array $params = [] )
Deletes a domain unit.
DeleteEnvironment ( array $params = [] )
Deletes an environment in Amazon DataZone.
DeleteEnvironmentAction ( array $params = [] )
Deletes an action for the environment, for example, deletes a console link for an analytics tool that is available in this environment.
DeleteEnvironmentBlueprintConfiguration ( array $params = [] )
Deletes the blueprint configuration in Amazon DataZone.
DeleteEnvironmentProfile ( array $params = [] )
Deletes an environment profile in Amazon DataZone.
DeleteFormType ( array $params = [] )
Delets and metadata form type in Amazon DataZone.
DeleteGlossary ( array $params = [] )
Deletes a business glossary in Amazon DataZone.
DeleteGlossaryTerm ( array $params = [] )
Deletes a business glossary term in Amazon DataZone.
DeleteListing ( array $params = [] )
Deletes a listing (a record of an asset at a given time).
DeleteProject ( array $params = [] )
Deletes a project in Amazon DataZone.
DeleteProjectMembership ( array $params = [] )
Deletes project membership in Amazon DataZone.
DeleteProjectProfile ( array $params = [] )
Deletes a project profile.
DeleteRule ( array $params = [] )
Deletes a rule in Amazon DataZone.
DeleteSubscriptionGrant ( array $params = [] )
Deletes and subscription grant in Amazon DataZone.
DeleteSubscriptionRequest ( array $params = [] )
Deletes a subscription request in Amazon DataZone.
DeleteSubscriptionTarget ( array $params = [] )
Deletes a subscription target in Amazon DataZone.
DeleteTimeSeriesDataPoints ( array $params = [] )
Deletes the specified time series form for the specified asset.
DisassociateEnvironmentRole ( array $params = [] )
Disassociates the environment role in Amazon DataZone.
GetAsset ( array $params = [] )
Gets an Amazon DataZone asset.
GetAssetFilter ( array $params = [] )
Gets an asset filter.
GetAssetType ( array $params = [] )
Gets an Amazon DataZone asset type.
GetConnection ( array $params = [] )
Gets a connection.
GetDataProduct ( array $params = [] )
Gets the data product.
GetDataSource ( array $params = [] )
Gets an Amazon DataZone data source.
GetDataSourceRun ( array $params = [] )
Gets an Amazon DataZone data source run.
GetDomain ( array $params = [] )
Gets an Amazon DataZone domain.
GetDomainUnit ( array $params = [] )
Gets the details of the specified domain unit.
GetEnvironment ( array $params = [] )
Gets an Amazon DataZone environment.
GetEnvironmentAction ( array $params = [] )
Gets the specified environment action.
GetEnvironmentBlueprint ( array $params = [] )
Gets an Amazon DataZone blueprint.
GetEnvironmentBlueprintConfiguration ( array $params = [] )
Gets the blueprint configuration in Amazon DataZone.
GetEnvironmentCredentials ( array $params = [] )
Gets the credentials of an environment in Amazon DataZone.
GetEnvironmentProfile ( array $params = [] )
Gets an evinronment profile in Amazon DataZone.
GetFormType ( array $params = [] )
Gets a metadata form type in Amazon DataZone.
GetGlossary ( array $params = [] )
Gets a business glossary in Amazon DataZone.
GetGlossaryTerm ( array $params = [] )
Gets a business glossary term in Amazon DataZone.
GetGroupProfile ( array $params = [] )
Gets a group profile in Amazon DataZone.
GetIamPortalLoginUrl ( array $params = [] )
Gets the data portal URL for the specified Amazon DataZone domain.
GetJobRun ( array $params = [] )
The details of the job run.
GetLineageEvent ( array $params = [] )
Describes the lineage event.
GetLineageNode ( array $params = [] )
Gets the data lineage node.
GetListing ( array $params = [] )
Gets a listing (a record of an asset at a given time).
GetMetadataGenerationRun ( array $params = [] )
Gets a metadata generation run in Amazon DataZone.
GetProject ( array $params = [] )
Gets a project in Amazon DataZone.
GetProjectProfile ( array $params = [] )
The details of the project profile.
GetRule ( array $params = [] )
Gets the details of a rule in Amazon DataZone.
GetSubscription ( array $params = [] )
Gets a subscription in Amazon DataZone.
GetSubscriptionGrant ( array $params = [] )
Gets the subscription grant in Amazon DataZone.
GetSubscriptionRequestDetails ( array $params = [] )
Gets the details of the specified subscription request.
GetSubscriptionTarget ( array $params = [] )
Gets the subscription target in Amazon DataZone.
GetTimeSeriesDataPoint ( array $params = [] )
Gets the existing data point for the asset.
GetUserProfile ( array $params = [] )
Gets a user profile in Amazon DataZone.
ListAssetFilters ( array $params = [] )
Lists asset filters.
ListAssetRevisions ( array $params = [] )
Lists the revisions for the asset.
ListConnections ( array $params = [] )
Lists connections.
ListDataProductRevisions ( array $params = [] )
Lists data product revisions.
ListDataSourceRunActivities ( array $params = [] )
Lists data source run activities.
ListDataSourceRuns ( array $params = [] )
Lists data source runs in Amazon DataZone.
ListDataSources ( array $params = [] )
Lists data sources in Amazon DataZone.
ListDomainUnitsForParent ( array $params = [] )
Lists child domain units for the specified parent domain unit.
ListDomains ( array $params = [] )
Lists Amazon DataZone domains.
ListEntityOwners ( array $params = [] )
Lists the entity (domain units) owners.
ListEnvironmentActions ( array $params = [] )
Lists existing environment actions.
ListEnvironmentBlueprintConfigurations ( array $params = [] )
Lists blueprint configurations for a Amazon DataZone environment.
ListEnvironmentBlueprints ( array $params = [] )
Lists blueprints in an Amazon DataZone environment.
ListEnvironmentProfiles ( array $params = [] )
Lists Amazon DataZone environment profiles.
ListEnvironments ( array $params = [] )
Lists Amazon DataZone environments.
ListJobRuns ( array $params = [] )
Lists job runs.
ListLineageEvents ( array $params = [] )
Lists lineage events.
ListLineageNodeHistory ( array $params = [] )
Lists the history of the specified data lineage node.
ListMetadataGenerationRuns ( array $params = [] )
Lists all metadata generation runs.
ListNotifications ( array $params = [] )
Lists all Amazon DataZone notifications.
ListPolicyGrants ( array $params = [] )
Lists policy grants.
ListProjectMemberships ( array $params = [] )
Lists all members of the specified project.
ListProjectProfiles ( array $params = [] )
Lists project profiles.
ListProjects ( array $params = [] )
Lists Amazon DataZone projects.
ListRules ( array $params = [] )
Lists existing rules.
ListSubscriptionGrants ( array $params = [] )
Lists subscription grants.
ListSubscriptionRequests ( array $params = [] )
Lists Amazon DataZone subscription requests.
ListSubscriptionTargets ( array $params = [] )
Lists subscription targets in Amazon DataZone.
ListSubscriptions ( array $params = [] )
Lists subscriptions in Amazon DataZone.
ListTagsForResource ( array $params = [] )
Lists tags for the specified resource in Amazon DataZone.
ListTimeSeriesDataPoints ( array $params = [] )
Lists time series data points.
PostLineageEvent ( array $params = [] )
Posts a data lineage event.
PostTimeSeriesDataPoints ( array $params = [] )
Posts time series data points to Amazon DataZone for the specified asset.
PutEnvironmentBlueprintConfiguration ( array $params = [] )
Writes the configuration for the specified environment blueprint in Amazon DataZone.
RejectPredictions ( array $params = [] )
Rejects automatically generated business-friendly metadata for your Amazon DataZone assets.
RejectSubscriptionRequest ( array $params = [] )
Rejects the specified subscription request.
RemoveEntityOwner ( array $params = [] )
Removes an owner from an entity.
RemovePolicyGrant ( array $params = [] )
Removes a policy grant.
RevokeSubscription ( array $params = [] )
Revokes a specified subscription in Amazon DataZone.
Search ( array $params = [] )
Searches for assets in Amazon DataZone.
SearchGroupProfiles ( array $params = [] )
Searches group profiles in Amazon DataZone.
SearchListings ( array $params = [] )
Searches listings (records of an asset at a given time) in Amazon DataZone.
SearchTypes ( array $params = [] )
Searches for types in Amazon DataZone.
SearchUserProfiles ( array $params = [] )
Searches user profiles in Amazon DataZone.
StartDataSourceRun ( array $params = [] )
Start the run of the specified data source in Amazon DataZone.
StartMetadataGenerationRun ( array $params = [] )
Starts the metadata generation run.
TagResource ( array $params = [] )
Tags a resource in Amazon DataZone.
UntagResource ( array $params = [] )
Untags a resource in Amazon DataZone.
UpdateAssetFilter ( array $params = [] )
Updates an asset filter.
UpdateConnection ( array $params = [] )
Updates a connection.
UpdateDataSource ( array $params = [] )
Updates the specified data source in Amazon DataZone.
UpdateDomain ( array $params = [] )
Updates a Amazon DataZone domain.
UpdateDomainUnit ( array $params = [] )
Updates the domain unit.
UpdateEnvironment ( array $params = [] )
Updates the specified environment in Amazon DataZone.
UpdateEnvironmentAction ( array $params = [] )
Updates an environment action.
UpdateEnvironmentProfile ( array $params = [] )
Updates the specified environment profile in Amazon DataZone.
UpdateGlossary ( array $params = [] )
Updates the business glossary in Amazon DataZone.
UpdateGlossaryTerm ( array $params = [] )
Updates a business glossary term in Amazon DataZone.
UpdateGroupProfile ( array $params = [] )
Updates the specified group profile in Amazon DataZone.
UpdateProject ( array $params = [] )
Updates the specified project in Amazon DataZone.
UpdateProjectProfile ( array $params = [] )
Updates a project profile.
UpdateRule ( array $params = [] )
Updates a rule.
UpdateSubscriptionGrantStatus ( array $params = [] )
Updates the status of the specified subscription grant status in Amazon DataZone.
UpdateSubscriptionRequest ( array $params = [] )
Updates a specified subscription request in Amazon DataZone.
UpdateSubscriptionTarget ( array $params = [] )
Updates the specified subscription target in Amazon DataZone.
UpdateUserProfile ( array $params = [] )
Updates the specified user profile in Amazon DataZone.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListAssetFilters
ListAssetRevisions
ListConnections
ListDataProductRevisions
ListDataSourceRunActivities
ListDataSourceRuns
ListDataSources
ListDomainUnitsForParent
ListDomains
ListEntityOwners
ListEnvironmentActions
ListEnvironmentBlueprintConfigurations
ListEnvironmentBlueprints
ListEnvironmentProfiles
ListEnvironments
ListJobRuns
ListLineageEvents
ListLineageNodeHistory
ListMetadataGenerationRuns
ListNotifications
ListPolicyGrants
ListProjectMemberships
ListProjectProfiles
ListProjects
ListRules
ListSubscriptionGrants
ListSubscriptionRequests
ListSubscriptionTargets
ListSubscriptions
ListTimeSeriesDataPoints
Search
SearchGroupProfiles
SearchListings
SearchTypes
SearchUserProfiles

Operations

AcceptPredictions

$result = $client->acceptPredictions([/* ... */]);
$promise = $client->acceptPredictionsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->acceptPredictions([
    'acceptChoices' => [
        [
            'editedValue' => '<string>',
            'predictionChoice' => <integer>,
            'predictionTarget' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'acceptRule' => [
        'rule' => 'ALL|NONE',
        'threshold' => <float>,
    ],
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'revision' => '<string>',
]);

Parameter Details

Members
acceptChoices
Type: Array of AcceptChoice structures

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

acceptRule
Type: AcceptRule structure

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

clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

identifier
Required: Yes
Type: string

The identifier of the asset.

revision
Type: string

The revision that is to be made to the asset.

Result Syntax

[
    'assetId' => '<string>',
    'domainId' => '<string>',
    'revision' => '<string>',
]

Result Details

Members
assetId
Required: Yes
Type: string

The ID of the asset.

domainId
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

revision
Required: Yes
Type: string

The revision that is to be made to the asset.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

AcceptSubscriptionRequest

$result = $client->acceptSubscriptionRequest([/* ... */]);
$promise = $client->acceptSubscriptionRequestAsync([/* ... */]);

Accepts a subscription request to a specific asset.

Parameter Syntax

$result = $client->acceptSubscriptionRequest([
    'assetScopes' => [
        [
            'assetId' => '<string>', // REQUIRED
            'filterIds' => ['<string>', ...], // REQUIRED
        ],
        // ...
    ],
    'decisionComment' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
assetScopes
Type: Array of AcceptedAssetScope structures

The asset scopes of the accept subscription request.

decisionComment
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

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

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'decisionComment' => '<string>',
    'domainId' => '<string>',
    'existingSubscriptionId' => '<string>',
    'id' => '<string>',
    'metadataForms' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'requestReason' => '<string>',
    'reviewerId' => '<string>',
    'status' => 'PENDING|ACCEPTED|REJECTED',
    'subscribedListings' => [
        [
            'description' => '<string>',
            'id' => '<string>',
            'item' => [
                'assetListing' => [
                    'assetScope' => [
                        'assetId' => '<string>',
                        'errorMessage' => '<string>',
                        'filterIds' => ['<string>', ...],
                        'status' => '<string>',
                    ],
                    'entityId' => '<string>',
                    'entityRevision' => '<string>',
                    'entityType' => '<string>',
                    'forms' => '<string>',
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                ],
                'productListing' => [
                    'assetListings' => [
                        [
                            'entityId' => '<string>',
                            'entityRevision' => '<string>',
                            'entityType' => '<string>',
                        ],
                        // ...
                    ],
                    'description' => '<string>',
                    'entityId' => '<string>',
                    'entityRevision' => '<string>',
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                    'name' => '<string>',
                ],
            ],
            'name' => '<string>',
            'ownerProjectId' => '<string>',
            'ownerProjectName' => '<string>',
            'revision' => '<string>',
        ],
        // ...
    ],
    'subscribedPrincipals' => [
        [
            'project' => [
                'id' => '<string>',
                'name' => '<string>',
            ],
        ],
        // ...
    ],
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp that specifies when the subscription request was accepted.

createdBy
Required: Yes
Type: string

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

decisionComment
Type: string

Specifies the reason for accepting the subscription request.

domainId
Required: Yes
Type: string

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

existingSubscriptionId
Type: string

The ID of the existing subscription.

id
Required: Yes
Type: string

The identifier of the subscription request.

metadataForms
Type: Array of FormOutput structures

The metadata form in the subscription request.

requestReason
Required: Yes
Type: string

Specifies the reason for requesting a subscription to the asset.

reviewerId
Type: string

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

status
Required: Yes
Type: string

Specifies the status of the subscription request.

subscribedListings
Required: Yes
Type: Array of SubscribedListing structures

Specifies the asset for which the subscription request was created.

subscribedPrincipals
Required: Yes
Type: Array of SubscribedPrincipal structures

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

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

Specifies the timestamp when subscription request was updated.

updatedBy
Type: string

Specifies the Amazon DataZone user who updated the subscription request.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

AddEntityOwner

$result = $client->addEntityOwner([/* ... */]);
$promise = $client->addEntityOwnerAsync([/* ... */]);

Adds the owner of an entity (a domain unit).

Parameter Syntax

$result = $client->addEntityOwner([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityType' => 'DOMAIN_UNIT', // REQUIRED
    'owner' => [ // REQUIRED
        'group' => [
            'groupIdentifier' => '<string>', // REQUIRED
        ],
        'user' => [
            'userIdentifier' => '<string>', // REQUIRED
        ],
    ],
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

The ID of the domain in which you want to add the entity owner.

entityIdentifier
Required: Yes
Type: string

The ID of the entity to which you want to add an owner.

entityType
Required: Yes
Type: string

The type of an entity.

owner
Required: Yes
Type: OwnerProperties structure

The owner that you want to add to the entity.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

AddPolicyGrant

$result = $client->addPolicyGrant([/* ... */]);
$promise = $client->addPolicyGrantAsync([/* ... */]);

Adds a policy grant (an authorization policy) to a specified entity, including domain units, environment blueprint configurations, or environment profiles.

Parameter Syntax

$result = $client->addPolicyGrant([
    'clientToken' => '<string>',
    'detail' => [ // REQUIRED
        'addToProjectMemberPool' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createAssetType' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createDomainUnit' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createEnvironment' => [
        ],
        'createEnvironmentFromBlueprint' => [
        ],
        'createEnvironmentProfile' => [
            'domainUnitId' => '<string>',
        ],
        'createFormType' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createGlossary' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createProject' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createProjectFromProjectProfile' => [
            'includeChildDomainUnits' => true || false,
            'projectProfiles' => ['<string>', ...],
        ],
        'delegateCreateEnvironmentProfile' => [
        ],
        'overrideDomainUnitOwners' => [
            'includeChildDomainUnits' => true || false,
        ],
        'overrideProjectOwners' => [
            'includeChildDomainUnits' => true || false,
        ],
    ],
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityType' => 'DOMAIN_UNIT|ENVIRONMENT_BLUEPRINT_CONFIGURATION|ENVIRONMENT_PROFILE', // REQUIRED
    'policyType' => 'CREATE_DOMAIN_UNIT|OVERRIDE_DOMAIN_UNIT_OWNERS|ADD_TO_PROJECT_MEMBER_POOL|OVERRIDE_PROJECT_OWNERS|CREATE_GLOSSARY|CREATE_FORM_TYPE|CREATE_ASSET_TYPE|CREATE_PROJECT|CREATE_ENVIRONMENT_PROFILE|DELEGATE_CREATE_ENVIRONMENT_PROFILE|CREATE_ENVIRONMENT|CREATE_ENVIRONMENT_FROM_BLUEPRINT|CREATE_PROJECT_FROM_PROJECT_PROFILE', // REQUIRED
    'principal' => [ // REQUIRED
        'domainUnit' => [
            'domainUnitDesignation' => 'OWNER', // REQUIRED
            'domainUnitGrantFilter' => [
                'allDomainUnitsGrantFilter' => [
                ],
            ],
            'domainUnitIdentifier' => '<string>',
        ],
        'group' => [
            'groupIdentifier' => '<string>',
        ],
        'project' => [
            'projectDesignation' => 'OWNER|CONTRIBUTOR|PROJECT_CATALOG_STEWARD', // REQUIRED
            'projectGrantFilter' => [
                'domainUnitFilter' => [
                    'domainUnit' => '<string>', // REQUIRED
                    'includeChildDomainUnits' => true || false,
                ],
            ],
            'projectIdentifier' => '<string>',
        ],
        'user' => [
            'allUsersGrantFilter' => [
            ],
            'userIdentifier' => '<string>',
        ],
    ],
]);

Parameter Details

Members
clientToken
Type: string

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

detail
Required: Yes
Type: PolicyGrantDetail structure

The details of the policy grant.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to add a policy grant.

entityIdentifier
Required: Yes
Type: string

The ID of the entity (resource) to which you want to add a policy grant.

entityType
Required: Yes
Type: string

The type of entity (resource) to which the grant is added.

policyType
Required: Yes
Type: string

The type of policy that you want to grant.

principal
Required: Yes
Type: PolicyGrantPrincipal structure

The principal to whom the permissions are granted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

AssociateEnvironmentRole

$result = $client->associateEnvironmentRole([/* ... */]);
$promise = $client->associateEnvironmentRoleAsync([/* ... */]);

Associates the environment role in Amazon DataZone.

Parameter Syntax

$result = $client->associateEnvironmentRole([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'environmentRoleArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone environment.

environmentRoleArn
Required: Yes
Type: string

The ARN of the environment role.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CancelMetadataGenerationRun

$result = $client->cancelMetadataGenerationRun([/* ... */]);
$promise = $client->cancelMetadataGenerationRunAsync([/* ... */]);

Cancels the metadata generation run.

Parameter Syntax

$result = $client->cancelMetadataGenerationRun([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which the metadata generation run is to be cancelled.

identifier
Required: Yes
Type: string

The ID of the metadata generation run.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CancelSubscription

$result = $client->cancelSubscription([/* ... */]);
$promise = $client->cancelSubscriptionAsync([/* ... */]);

Cancels the subscription to the specified asset.

Parameter Syntax

$result = $client->cancelSubscription([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The unique identifier of the subscription that is being cancelled.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'retainPermissions' => true || false,
    'status' => 'APPROVED|REVOKED|CANCELLED',
    'subscribedListing' => [
        'description' => '<string>',
        'id' => '<string>',
        'item' => [
            'assetListing' => [
                'assetScope' => [
                    'assetId' => '<string>',
                    'errorMessage' => '<string>',
                    'filterIds' => ['<string>', ...],
                    'status' => '<string>',
                ],
                'entityId' => '<string>',
                'entityRevision' => '<string>',
                'entityType' => '<string>',
                'forms' => '<string>',
                'glossaryTerms' => [
                    [
                        'name' => '<string>',
                        'shortDescription' => '<string>',
                    ],
                    // ...
                ],
            ],
            'productListing' => [
                'assetListings' => [
                    [
                        'entityId' => '<string>',
                        'entityRevision' => '<string>',
                        'entityType' => '<string>',
                    ],
                    // ...
                ],
                'description' => '<string>',
                'entityId' => '<string>',
                'entityRevision' => '<string>',
                'glossaryTerms' => [
                    [
                        'name' => '<string>',
                        'shortDescription' => '<string>',
                    ],
                    // ...
                ],
                'name' => '<string>',
            ],
        ],
        'name' => '<string>',
        'ownerProjectId' => '<string>',
        'ownerProjectName' => '<string>',
        'revision' => '<string>',
    ],
    'subscribedPrincipal' => [
        'project' => [
            'id' => '<string>',
            'name' => '<string>',
        ],
    ],
    'subscriptionRequestId' => '<string>',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp that specifies when the request to cancel the subscription was created.

createdBy
Required: Yes
Type: string

Specifies the Amazon DataZone user who is cancelling the subscription.

domainId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The identifier of the subscription.

retainPermissions
Type: boolean

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

status
Required: Yes
Type: string

The status of the request to cancel the subscription.

subscribedListing
Required: Yes
Type: SubscribedListing structure

The asset to which a subscription is being cancelled.

subscribedPrincipal
Required: Yes
Type: SubscribedPrincipal structure

The Amazon DataZone user who is made a subscriber to the specified asset by the subscription that is being cancelled.

subscriptionRequestId
Type: string

The unique ID of the subscripton request for the subscription that is being cancelled.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp that specifies when the subscription was cancelled.

updatedBy
Type: string

The Amazon DataZone user that cancelled the subscription.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateAsset

$result = $client->createAsset([/* ... */]);
$promise = $client->createAssetAsync([/* ... */]);

Creates an asset in Amazon DataZone catalog.

Parameter Syntax

$result = $client->createAsset([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'externalIdentifier' => '<string>',
    'formsInput' => [
        [
            'content' => '<string>',
            'formName' => '<string>', // REQUIRED
            'typeIdentifier' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'name' => '<string>', // REQUIRED
    'owningProjectIdentifier' => '<string>', // REQUIRED
    'predictionConfiguration' => [
        'businessNameGeneration' => [
            'enabled' => true || false,
        ],
    ],
    'typeIdentifier' => '<string>', // REQUIRED
    'typeRevision' => '<string>',
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

Asset description.

domainIdentifier
Required: Yes
Type: string

Amazon DataZone domain where the asset is created.

externalIdentifier
Type: string

The external identifier of the asset.

formsInput
Type: Array of FormInput structures

Metadata forms attached to the asset.

glossaryTerms
Type: Array of strings

Glossary terms attached to the asset.

name
Required: Yes
Type: string

Asset name.

owningProjectIdentifier
Required: Yes
Type: string

The unique identifier of the project that owns this asset.

predictionConfiguration
Type: PredictionConfiguration structure

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

typeIdentifier
Required: Yes
Type: string

The unique identifier of this asset's type.

typeRevision
Type: string

The revision of this asset's type.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'externalIdentifier' => '<string>',
    'firstRevisionCreatedAt' => <DateTime>,
    'firstRevisionCreatedBy' => '<string>',
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'latestTimeSeriesDataPointFormsOutput' => [
        [
            'contentSummary' => '<string>',
            'formName' => '<string>',
            'id' => '<string>',
            'timestamp' => <DateTime>,
            'typeIdentifier' => '<string>',
            'typeRevision' => '<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>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the asset was created.

createdBy
Type: string

The Amazon DataZone user that created this asset in the catalog.

description
Type: string

The description of the created asset.

domainId
Required: Yes
Type: string

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

externalIdentifier
Type: string

The external identifier of the asset.

firstRevisionCreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the first revision of the asset took place.

firstRevisionCreatedBy
Type: string

The Amazon DataZone user that made the first revision of the asset.

formsOutput
Required: Yes
Type: Array of FormOutput structures

The metadata forms that are attached to the created asset.

glossaryTerms
Type: Array of strings

The glossary terms that are attached to the created asset.

id
Required: Yes
Type: string

The unique identifier of the created asset.

latestTimeSeriesDataPointFormsOutput
Type: Array of TimeSeriesDataPointSummaryFormOutput structures

The latest data point that was imported into the time series form for the asset.

listing
Type: AssetListingDetails structure

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

name
Required: Yes
Type: string

The name of the created asset.

owningProjectId
Required: Yes
Type: string

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

predictionConfiguration
Type: PredictionConfiguration structure

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

readOnlyFormsOutput
Type: Array of FormOutput structures

The read-only metadata forms that are attached to the created asset.

revision
Required: Yes
Type: string

The revision of the asset.

typeIdentifier
Required: Yes
Type: string

The identifier of the created asset type.

typeRevision
Required: Yes
Type: string

The revision type of the asset.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateAssetFilter

$result = $client->createAssetFilter([/* ... */]);
$promise = $client->createAssetFilterAsync([/* ... */]);

Creates a data asset filter.

Parameter Syntax

$result = $client->createAssetFilter([
    'assetIdentifier' => '<string>', // REQUIRED
    'clientToken' => '<string>',
    'configuration' => [ // REQUIRED
        'columnConfiguration' => [
            'includedColumnNames' => ['<string>', ...],
        ],
        'rowConfiguration' => [
            'rowFilter' => [ // REQUIRED
                'and' => [
                    [...], // RECURSIVE
                    // ...
                ],
                'expression' => [
                    'equalTo' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'greaterThan' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'greaterThanOrEqualTo' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'in' => [
                        'columnName' => '<string>', // REQUIRED
                        'values' => ['<string>', ...], // REQUIRED
                    ],
                    'isNotNull' => [
                        'columnName' => '<string>', // REQUIRED
                    ],
                    'isNull' => [
                        'columnName' => '<string>', // REQUIRED
                    ],
                    'lessThan' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'lessThanOrEqualTo' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'like' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'notEqualTo' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    'notIn' => [
                        'columnName' => '<string>', // REQUIRED
                        'values' => ['<string>', ...], // REQUIRED
                    ],
                    'notLike' => [
                        'columnName' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                ],
                'or' => [
                    [...], // RECURSIVE
                    // ...
                ],
            ],
            'sensitive' => true || false,
        ],
    ],
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
]);

Parameter Details

Members
assetIdentifier
Required: Yes
Type: string

The ID of the data asset.

clientToken
Type: string

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

configuration
Required: Yes
Type: AssetFilterConfiguration structure

The configuration of the asset filter.

description
Type: string

The description of the asset filter.

domainIdentifier
Required: Yes
Type: string

The ID of the domain in which you want to create an asset filter.

name
Required: Yes
Type: string

The name of the asset filter.

Result Syntax

[
    'assetId' => '<string>',
    'configuration' => [
        'columnConfiguration' => [
            'includedColumnNames' => ['<string>', ...],
        ],
        'rowConfiguration' => [
            'rowFilter' => [
                'and' => [
                    [...], // RECURSIVE
                    // ...
                ],
                'expression' => [
                    'equalTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'greaterThan' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'greaterThanOrEqualTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'in' => [
                        'columnName' => '<string>',
                        'values' => ['<string>', ...],
                    ],
                    'isNotNull' => [
                        'columnName' => '<string>',
                    ],
                    'isNull' => [
                        'columnName' => '<string>',
                    ],
                    'lessThan' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'lessThanOrEqualTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'like' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'notEqualTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'notIn' => [
                        'columnName' => '<string>',
                        'values' => ['<string>', ...],
                    ],
                    'notLike' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                ],
                'or' => [
                    [...], // RECURSIVE
                    // ...
                ],
            ],
            'sensitive' => true || false,
        ],
    ],
    'createdAt' => <DateTime>,
    'description' => '<string>',
    'domainId' => '<string>',
    'effectiveColumnNames' => ['<string>', ...],
    'effectiveRowFilter' => '<string>',
    'errorMessage' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'status' => 'VALID|INVALID',
]

Result Details

Members
assetId
Required: Yes
Type: string

The ID of the asset.

configuration
Required: Yes
Type: AssetFilterConfiguration structure

The configuration of the asset filter.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the asset filter was created.

description
Type: string

The description of the asset filter.

domainId
Required: Yes
Type: string

The ID of the domain where the asset filter is created.

effectiveColumnNames
Type: Array of strings

The column names in the asset filter.

effectiveRowFilter
Type: string

The row filter in the asset filter.

errorMessage
Type: string

The error message that is displayed if the asset filter is not created successfully.

id
Required: Yes
Type: string

The ID of the asset filter.

name
Required: Yes
Type: string

The name of the asset filter.

status
Type: string

The status of the asset filter.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateAssetRevision

$result = $client->createAssetRevision([/* ... */]);
$promise = $client->createAssetRevisionAsync([/* ... */]);

Creates a revision of the asset.

Parameter Syntax

$result = $client->createAssetRevision([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'formsInput' => [
        [
            'content' => '<string>',
            'formName' => '<string>', // REQUIRED
            'typeIdentifier' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'identifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'predictionConfiguration' => [
        'businessNameGeneration' => [
            'enabled' => true || false,
        ],
    ],
    'typeRevision' => '<string>',
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

The revised description of the asset.

domainIdentifier
Required: Yes
Type: string

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

formsInput
Type: Array of FormInput structures

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

glossaryTerms
Type: Array of strings

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

identifier
Required: Yes
Type: string

The identifier of the asset.

name
Required: Yes
Type: string

Te revised name of the asset.

predictionConfiguration
Type: PredictionConfiguration structure

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

typeRevision
Type: string

The revision type of the asset.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'externalIdentifier' => '<string>',
    'firstRevisionCreatedAt' => <DateTime>,
    'firstRevisionCreatedBy' => '<string>',
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'latestTimeSeriesDataPointFormsOutput' => [
        [
            'contentSummary' => '<string>',
            'formName' => '<string>',
            'id' => '<string>',
            'timestamp' => <DateTime>,
            'typeIdentifier' => '<string>',
            'typeRevision' => '<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>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the asset revision occured.

createdBy
Type: string

The Amazon DataZone user who performed the asset revision.

description
Type: string

The revised asset description.

domainId
Required: Yes
Type: string

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

externalIdentifier
Type: string

The external identifier of the asset.

firstRevisionCreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the first asset revision occured.

firstRevisionCreatedBy
Type: string

The Amazon DataZone user who performed the first asset revision.

formsOutput
Required: Yes
Type: Array of FormOutput structures

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

glossaryTerms
Type: Array of strings

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

id
Required: Yes
Type: string

The unique identifier of the asset revision.

latestTimeSeriesDataPointFormsOutput
Type: Array of TimeSeriesDataPointSummaryFormOutput structures

The latest data point that was imported into the time series form for the asset.

listing
Type: AssetListingDetails structure

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

name
Required: Yes
Type: string

The revised name of the asset.

owningProjectId
Required: Yes
Type: string

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

predictionConfiguration
Type: PredictionConfiguration structure

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

readOnlyFormsOutput
Type: Array of FormOutput structures

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

revision
Required: Yes
Type: string

The revision of the asset.

typeIdentifier
Required: Yes
Type: string

The identifier of the revision type.

typeRevision
Required: Yes
Type: string

The revision type of the asset.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateAssetType

$result = $client->createAssetType([/* ... */]);
$promise = $client->createAssetTypeAsync([/* ... */]);

Creates a custom asset type.

Parameter Syntax

$result = $client->createAssetType([
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'formsInput' => [ // REQUIRED
        '<FormName>' => [
            'required' => true || false,
            'typeIdentifier' => '<string>', // REQUIRED
            'typeRevision' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'name' => '<string>', // REQUIRED
    'owningProjectIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
description
Type: string

The descripton of the custom asset type.

domainIdentifier
Required: Yes
Type: string

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

formsInput
Required: Yes
Type: Associative array of custom strings keys (FormName) to FormEntryInput structures

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

name
Required: Yes
Type: string

The name of the custom asset type.

owningProjectIdentifier
Required: Yes
Type: string

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

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'formsOutput' => [
        '<FormName>' => [
            'required' => true || false,
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>',
    'originDomainId' => '<string>',
    'originProjectId' => '<string>',
    'owningProjectId' => '<string>',
    'revision' => '<string>',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

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

createdBy
Type: string

The Amazon DataZone user who creates this custom asset type.

description
Type: string

The description of the custom asset type.

domainId
Required: Yes
Type: string

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

formsOutput
Required: Yes
Type: Associative array of custom strings keys (FormName) to FormEntryOutput structures

The metadata forms that are attached to the asset type.

name
Required: Yes
Type: string

The name of the asset type.

originDomainId
Type: string

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

originProjectId
Type: string

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

owningProjectId
Type: string

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

revision
Required: Yes
Type: string

The revision of the custom asset type.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the custom type was created.

updatedBy
Type: string

The Amazon DataZone user that created the custom asset type.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateConnection

$result = $client->createConnection([/* ... */]);
$promise = $client->createConnectionAsync([/* ... */]);

Creates a new connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.

Parameter Syntax

$result = $client->createConnection([
    'awsLocation' => [
        'accessRole' => '<string>',
        'awsAccountId' => '<string>',
        'awsRegion' => '<string>',
        'iamConnectionId' => '<string>',
    ],
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'props' => [
        'athenaProperties' => [
            'workgroupName' => '<string>',
        ],
        'glueProperties' => [
            'glueConnectionInput' => [
                'athenaProperties' => ['<string>', ...],
                'authenticationConfiguration' => [
                    'authenticationType' => 'BASIC|OAUTH2|CUSTOM',
                    'basicAuthenticationCredentials' => [
                        'password' => '<string>',
                        'userName' => '<string>',
                    ],
                    'customAuthenticationCredentials' => ['<string>', ...],
                    'kmsKeyArn' => '<string>',
                    'oAuth2Properties' => [
                        'authorizationCodeProperties' => [
                            'authorizationCode' => '<string>',
                            'redirectUri' => '<string>',
                        ],
                        'oAuth2ClientApplication' => [
                            'aWSManagedClientApplicationReference' => '<string>',
                            'userManagedClientApplicationClientId' => '<string>',
                        ],
                        'oAuth2Credentials' => [
                            'accessToken' => '<string>',
                            'jwtToken' => '<string>',
                            'refreshToken' => '<string>',
                            'userManagedClientApplicationClientSecret' => '<string>',
                        ],
                        'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER',
                        'tokenUrl' => '<string>',
                        'tokenUrlParametersMap' => ['<string>', ...],
                    ],
                    'secretArn' => '<string>',
                ],
                'connectionProperties' => ['<string>', ...],
                'connectionType' => 'SNOWFLAKE|BIGQUERY|DOCUMENTDB|DYNAMODB|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SQLSERVER|TERADATA|VERTICA',
                'description' => '<string>',
                'matchCriteria' => '<string>',
                'name' => '<string>',
                'physicalConnectionRequirements' => [
                    'availabilityZone' => '<string>',
                    'securityGroupIdList' => ['<string>', ...],
                    'subnetId' => '<string>',
                    'subnetIdList' => ['<string>', ...],
                ],
                'pythonProperties' => ['<string>', ...],
                'sparkProperties' => ['<string>', ...],
                'validateCredentials' => true || false,
                'validateForComputeEnvironments' => ['<string>', ...],
            ],
        ],
        'hyperPodProperties' => [
            'clusterName' => '<string>', // REQUIRED
        ],
        'iamProperties' => [
            'glueLineageSyncEnabled' => true || false,
        ],
        'redshiftProperties' => [
            'credentials' => [
                'secretArn' => '<string>',
                'usernamePassword' => [
                    'password' => '<string>', // REQUIRED
                    'username' => '<string>', // REQUIRED
                ],
            ],
            'databaseName' => '<string>',
            'host' => '<string>',
            'lineageSync' => [
                'enabled' => true || false,
                'schedule' => [
                    'schedule' => '<string>',
                ],
            ],
            'port' => <integer>,
            'storage' => [
                'clusterName' => '<string>',
                'workgroupName' => '<string>',
            ],
        ],
        'sparkEmrProperties' => [
            'computeArn' => '<string>',
            'instanceProfileArn' => '<string>',
            'javaVirtualEnv' => '<string>',
            'logUri' => '<string>',
            'pythonVirtualEnv' => '<string>',
            'runtimeRole' => '<string>',
            'trustedCertificatesS3Uri' => '<string>',
        ],
        'sparkGlueProperties' => [
            'additionalArgs' => [
                'connection' => '<string>',
            ],
            'glueConnectionName' => '<string>',
            'glueVersion' => '<string>',
            'idleTimeout' => <integer>,
            'javaVirtualEnv' => '<string>',
            'numberOfWorkers' => <integer>,
            'pythonVirtualEnv' => '<string>',
            'workerType' => '<string>',
        ],
    ],
]);

Parameter Details

Members
awsLocation
Type: AwsLocation structure

The location where the connection is created.

clientToken
Type: string

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

description
Type: string

A connection description.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where the connection is created.

environmentIdentifier
Required: Yes
Type: string

The ID of the environment where the connection is created.

name
Required: Yes
Type: string

The connection name.

props
Type: ConnectionPropertiesInput structure

The connection props.

Result Syntax

[
    'connectionId' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'environmentId' => '<string>',
    'name' => '<string>',
    'physicalEndpoints' => [
        [
            'awsLocation' => [
                'accessRole' => '<string>',
                'awsAccountId' => '<string>',
                'awsRegion' => '<string>',
                'iamConnectionId' => '<string>',
            ],
            'glueConnection' => [
                'athenaProperties' => ['<string>', ...],
                'authenticationConfiguration' => [
                    'authenticationType' => 'BASIC|OAUTH2|CUSTOM',
                    'oAuth2Properties' => [
                        'authorizationCodeProperties' => [
                            'authorizationCode' => '<string>',
                            'redirectUri' => '<string>',
                        ],
                        'oAuth2ClientApplication' => [
                            'aWSManagedClientApplicationReference' => '<string>',
                            'userManagedClientApplicationClientId' => '<string>',
                        ],
                        'oAuth2Credentials' => [
                            'accessToken' => '<string>',
                            'jwtToken' => '<string>',
                            'refreshToken' => '<string>',
                            'userManagedClientApplicationClientSecret' => '<string>',
                        ],
                        'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER',
                        'tokenUrl' => '<string>',
                        'tokenUrlParametersMap' => ['<string>', ...],
                    ],
                    'secretArn' => '<string>',
                ],
                'compatibleComputeEnvironments' => ['<string>', ...],
                'connectionProperties' => ['<string>', ...],
                'connectionSchemaVersion' => <integer>,
                'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
                'creationTime' => <DateTime>,
                'description' => '<string>',
                'lastConnectionValidationTime' => <DateTime>,
                'lastUpdatedBy' => '<string>',
                'lastUpdatedTime' => <DateTime>,
                'matchCriteria' => ['<string>', ...],
                'name' => '<string>',
                'physicalConnectionRequirements' => [
                    'availabilityZone' => '<string>',
                    'securityGroupIdList' => ['<string>', ...],
                    'subnetId' => '<string>',
                    'subnetIdList' => ['<string>', ...],
                ],
                'pythonProperties' => ['<string>', ...],
                'sparkProperties' => ['<string>', ...],
                'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
                'statusReason' => '<string>',
            ],
            'glueConnectionName' => '<string>',
            'host' => '<string>',
            'port' => <integer>,
            'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM',
            'stage' => '<string>',
        ],
        // ...
    ],
    'projectId' => '<string>',
    'props' => [
        'athenaProperties' => [
            'workgroupName' => '<string>',
        ],
        'glueProperties' => [
            'errorMessage' => '<string>',
            'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
        ],
        'hyperPodProperties' => [
            'clusterArn' => '<string>',
            'clusterName' => '<string>',
            'orchestrator' => 'EKS|SLURM',
        ],
        'iamProperties' => [
            'environmentId' => '<string>',
            'glueLineageSyncEnabled' => true || false,
        ],
        'redshiftProperties' => [
            'credentials' => [
                'secretArn' => '<string>',
                'usernamePassword' => [
                    'password' => '<string>',
                    'username' => '<string>',
                ],
            ],
            'databaseName' => '<string>',
            'isProvisionedSecret' => true || false,
            'jdbcIamUrl' => '<string>',
            'jdbcUrl' => '<string>',
            'lineageSync' => [
                'enabled' => true || false,
                'lineageJobId' => '<string>',
                'schedule' => [
                    'schedule' => '<string>',
                ],
            ],
            'redshiftTempDir' => '<string>',
            'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
            'storage' => [
                'clusterName' => '<string>',
                'workgroupName' => '<string>',
            ],
        ],
        'sparkEmrProperties' => [
            'computeArn' => '<string>',
            'credentials' => [
                'password' => '<string>',
                'username' => '<string>',
            ],
            'credentialsExpiration' => <DateTime>,
            'governanceType' => 'AWS_MANAGED|USER_MANAGED',
            'instanceProfileArn' => '<string>',
            'javaVirtualEnv' => '<string>',
            'livyEndpoint' => '<string>',
            'logUri' => '<string>',
            'pythonVirtualEnv' => '<string>',
            'runtimeRole' => '<string>',
            'trustedCertificatesS3Uri' => '<string>',
        ],
        'sparkGlueProperties' => [
            'additionalArgs' => [
                'connection' => '<string>',
            ],
            'glueConnectionName' => '<string>',
            'glueVersion' => '<string>',
            'idleTimeout' => <integer>,
            'javaVirtualEnv' => '<string>',
            'numberOfWorkers' => <integer>,
            'pythonVirtualEnv' => '<string>',
            'workerType' => '<string>',
        ],
    ],
    'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
]

Result Details

Members
connectionId
Required: Yes
Type: string

The ID of the connection.

description
Type: string

The connection description.

domainId
Required: Yes
Type: string

The ID of the domain where the connection is created.

domainUnitId
Required: Yes
Type: string

The ID of the domain unit where the connection is created.

environmentId
Type: string

The ID of the environment where the connection is created.

name
Required: Yes
Type: string

The connection name.

physicalEndpoints
Required: Yes
Type: Array of PhysicalEndpoint structures

The physical endpoints of the connection.

projectId
Type: string

The ID of the project where the connection is created.

props
Type: ConnectionPropertiesOutput structure

The connection props.

type
Required: Yes
Type: string

The connection type.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateDataProduct

$result = $client->createDataProduct([/* ... */]);
$promise = $client->createDataProductAsync([/* ... */]);

Creates a data product.

Parameter Syntax

$result = $client->createDataProduct([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'formsInput' => [
        [
            'content' => '<string>',
            'formName' => '<string>', // REQUIRED
            'typeIdentifier' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'items' => [
        [
            'glossaryTerms' => ['<string>', ...],
            'identifier' => '<string>', // REQUIRED
            'itemType' => 'ASSET', // REQUIRED
            'revision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>', // REQUIRED
    'owningProjectIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

The description of the data product.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where the data product is created.

formsInput
Type: Array of FormInput structures

The metadata forms of the data product.

glossaryTerms
Type: Array of strings

The glossary terms of the data product.

items
Type: Array of DataProductItem structures

The data assets of the data product.

name
Required: Yes
Type: string

The name of the data product.

owningProjectIdentifier
Required: Yes
Type: string

The ID of the owning project of the data product.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'firstRevisionCreatedAt' => <DateTime>,
    'firstRevisionCreatedBy' => '<string>',
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'items' => [
        [
            'glossaryTerms' => ['<string>', ...],
            'identifier' => '<string>',
            'itemType' => 'ASSET',
            'revision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>',
    'owningProjectId' => '<string>',
    'revision' => '<string>',
    'status' => 'CREATED|CREATING|CREATE_FAILED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the data product was created.

createdBy
Type: string

The user who created the data product.

description
Type: string

The description of the data product.

domainId
Required: Yes
Type: string

The ID of the domain where the data product lives.

firstRevisionCreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the first revision of the data product was created.

firstRevisionCreatedBy
Type: string

The user who created the first revision of the data product.

formsOutput
Type: Array of FormOutput structures

The metadata forms of the data product.

glossaryTerms
Type: Array of strings

The glossary terms of the data product.

id
Required: Yes
Type: string

The ID of the data product.

items
Type: Array of DataProductItem structures

The data assets of the data product.

name
Required: Yes
Type: string

The name of the data product.

owningProjectId
Required: Yes
Type: string

The ID of the owning project of the data product.

revision
Required: Yes
Type: string

The revision of the data product.

status
Required: Yes
Type: string

The status of the data product.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateDataProductRevision

$result = $client->createDataProductRevision([/* ... */]);
$promise = $client->createDataProductRevisionAsync([/* ... */]);

Creates a data product revision.

Parameter Syntax

$result = $client->createDataProductRevision([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'formsInput' => [
        [
            'content' => '<string>',
            'formName' => '<string>', // REQUIRED
            'typeIdentifier' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'identifier' => '<string>', // REQUIRED
    'items' => [
        [
            'glossaryTerms' => ['<string>', ...],
            'identifier' => '<string>', // REQUIRED
            'itemType' => 'ASSET', // REQUIRED
            'revision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>', // REQUIRED
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

The description of the data product revision.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where the data product revision is created.

formsInput
Type: Array of FormInput structures

The metadata forms of the data product revision.

glossaryTerms
Type: Array of strings

The glossary terms of the data product revision.

identifier
Required: Yes
Type: string

The ID of the data product revision.

items
Type: Array of DataProductItem structures

The data assets of the data product revision.

name
Required: Yes
Type: string

The name of the data product revision.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'firstRevisionCreatedAt' => <DateTime>,
    'firstRevisionCreatedBy' => '<string>',
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'items' => [
        [
            'glossaryTerms' => ['<string>', ...],
            'identifier' => '<string>',
            'itemType' => 'ASSET',
            'revision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>',
    'owningProjectId' => '<string>',
    'revision' => '<string>',
    'status' => 'CREATED|CREATING|CREATE_FAILED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the data product revision is created.

createdBy
Type: string

The user who created the data product revision.

description
Type: string

The description of the data product revision.

domainId
Required: Yes
Type: string

The ID of the domain where data product revision is created.

firstRevisionCreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the first revision of the data product is created.

firstRevisionCreatedBy
Type: string

The user who created the first revision of the data product.

formsOutput
Type: Array of FormOutput structures

The metadata forms of the data product revision.

glossaryTerms
Type: Array of strings

The glossary terms of the data product revision.

id
Required: Yes
Type: string

The ID of the data product revision.

items
Type: Array of DataProductItem structures

The data assets of the data product revision.

name
Required: Yes
Type: string

The name of the data product revision.

owningProjectId
Required: Yes
Type: string

The ID of the owning project of the data product revision.

revision
Required: Yes
Type: string

The revision of the data product revision.

status
Required: Yes
Type: string

The status of the data product revision.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateDataSource

$result = $client->createDataSource([/* ... */]);
$promise = $client->createDataSourceAsync([/* ... */]);

Creates an Amazon DataZone data source.

Parameter Syntax

$result = $client->createDataSource([
    'assetFormsInput' => [
        [
            'content' => '<string>',
            'formName' => '<string>', // REQUIRED
            'typeIdentifier' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'clientToken' => '<string>',
    'configuration' => [
        'glueRunConfiguration' => [
            'autoImportDataQualityResult' => true || false,
            'catalogName' => '<string>',
            'dataAccessRole' => '<string>',
            'relationalFilterConfigurations' => [ // REQUIRED
                [
                    'databaseName' => '<string>', // REQUIRED
                    'filterExpressions' => [
                        [
                            'expression' => '<string>', // REQUIRED
                            'type' => 'INCLUDE|EXCLUDE', // REQUIRED
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
        'redshiftRunConfiguration' => [
            'dataAccessRole' => '<string>',
            'redshiftCredentialConfiguration' => [
                'secretManagerArn' => '<string>', // REQUIRED
            ],
            'redshiftStorage' => [
                'redshiftClusterSource' => [
                    'clusterName' => '<string>', // REQUIRED
                ],
                'redshiftServerlessSource' => [
                    'workgroupName' => '<string>', // REQUIRED
                ],
            ],
            'relationalFilterConfigurations' => [ // REQUIRED
                [
                    'databaseName' => '<string>', // REQUIRED
                    'filterExpressions' => [
                        [
                            'expression' => '<string>', // REQUIRED
                            'type' => 'INCLUDE|EXCLUDE', // REQUIRED
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
        'sageMakerRunConfiguration' => [
            'trackingAssets' => [ // REQUIRED
                '<SageMakerAssetType>' => ['<string>', ...],
                // ...
            ],
        ],
    ],
    'connectionIdentifier' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'enableSetting' => 'ENABLED|DISABLED',
    'environmentIdentifier' => '<string>',
    'name' => '<string>', // REQUIRED
    'projectIdentifier' => '<string>', // REQUIRED
    '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>', // REQUIRED
]);

Parameter Details

Members
assetFormsInput
Type: Array of FormInput structures

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

clientToken
Type: string

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

configuration

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

connectionIdentifier
Type: string

The ID of the connection.

description
Type: string

The description of the data source.

domainIdentifier
Required: Yes
Type: string

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

enableSetting
Type: string

Specifies whether the data source is enabled.

environmentIdentifier
Type: string

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

name
Required: Yes
Type: string

The name of the data source.

projectIdentifier
Required: Yes
Type: string

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

publishOnImport
Type: boolean

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

recommendation
Type: RecommendationConfiguration structure

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

schedule
Type: ScheduleConfiguration structure

The schedule of the data source runs.

type
Required: Yes
Type: string

The type of the data source.

Result Syntax

[
    'assetFormsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'configuration' => [
        'glueRunConfiguration' => [
            'accountId' => '<string>',
            'autoImportDataQualityResult' => true || false,
            'catalogName' => '<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>',
                ],
                // ...
            ],
        ],
        'sageMakerRunConfiguration' => [
            'accountId' => '<string>',
            'region' => '<string>',
            'trackingAssets' => [
                '<SageMakerAssetType>' => ['<string>', ...],
                // ...
            ],
        ],
    ],
    'connectionId' => '<string>',
    'createdAt' => <DateTime>,
    '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>,
    '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>,
]

Result Details

Members
assetFormsOutput
Type: Array of FormOutput structures

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

configuration

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

connectionId
Type: string

The ID of the connection.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the data source was created.

description
Type: string

The description of the data source.

domainId
Required: Yes
Type: string

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

enableSetting
Type: string

Specifies whether the data source is enabled.

environmentId
Type: string

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

errorMessage
Type: DataSourceErrorMessage structure

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

id
Required: Yes
Type: string

The unique identifier of the data source.

lastRunAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

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

lastRunErrorMessage
Type: DataSourceErrorMessage structure

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

lastRunStatus
Type: string

The status of the last run of this data source.

name
Required: Yes
Type: string

The name of the data source.

projectId
Required: Yes
Type: string

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

publishOnImport
Type: boolean

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

recommendation
Type: RecommendationConfiguration structure

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

schedule
Type: ScheduleConfiguration structure

The schedule of the data source runs.

status
Type: string

The status of the data source.

type
Type: string

The type of the data source.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the data source was updated.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateDomain

$result = $client->createDomain([/* ... */]);
$promise = $client->createDomainAsync([/* ... */]);

Creates an Amazon DataZone domain.

Parameter Syntax

$result = $client->createDomain([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainExecutionRole' => '<string>', // REQUIRED
    'domainVersion' => 'V1|V2',
    'kmsKeyIdentifier' => '<string>',
    'name' => '<string>', // REQUIRED
    'serviceRole' => '<string>',
    'singleSignOn' => [
        'type' => 'IAM_IDC|DISABLED',
        'userAssignment' => 'AUTOMATIC|MANUAL',
    ],
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

The description of the Amazon DataZone domain.

domainExecutionRole
Required: Yes
Type: 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.

domainVersion
Type: string

The version of the domain that is created.

kmsKeyIdentifier
Type: 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
Required: Yes
Type: string

The name of the Amazon DataZone domain.

serviceRole
Type: string

The service role of the domain that is created.

singleSignOn
Type: SingleSignOn structure

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

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags specified for the Amazon DataZone domain.

Result Syntax

[
    'arn' => '<string>',
    'description' => '<string>',
    'domainExecutionRole' => '<string>',
    'domainVersion' => 'V1|V2',
    'id' => '<string>',
    'kmsKeyIdentifier' => '<string>',
    'name' => '<string>',
    'portalUrl' => '<string>',
    'rootDomainUnitId' => '<string>',
    'serviceRole' => '<string>',
    'singleSignOn' => [
        'type' => 'IAM_IDC|DISABLED',
        'userAssignment' => 'AUTOMATIC|MANUAL',
    ],
    'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED',
    'tags' => ['<string>', ...],
]

Result Details

Members
arn
Type: string

The ARN of the Amazon DataZone domain.

description
Type: string

The description of the Amazon DataZone domain.

domainExecutionRole
Type: 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.

domainVersion
Type: string

The version of the domain that is created.

id
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

kmsKeyIdentifier
Type: 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
Type: string

The name of the Amazon DataZone domain.

portalUrl
Type: string

The URL of the data portal for this Amazon DataZone domain.

rootDomainUnitId
Type: string

The ID of the root domain unit.

serviceRole
Type: string

Te service role of the domain that is created.

singleSignOn
Type: SingleSignOn structure

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

status
Type: string

The status of the Amazon DataZone domain.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags specified for the Amazon DataZone domain.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateDomainUnit

$result = $client->createDomainUnit([/* ... */]);
$promise = $client->createDomainUnitAsync([/* ... */]);

Creates a domain unit in Amazon DataZone.

Parameter Syntax

$result = $client->createDomainUnit([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'parentDomainUnitIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

The description of the domain unit.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to crate a domain unit.

name
Required: Yes
Type: string

The name of the domain unit.

parentDomainUnitIdentifier
Required: Yes
Type: string

The ID of the parent domain unit.

Result Syntax

[
    'ancestorDomainUnitIds' => ['<string>', ...],
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'owners' => [
        [
            'group' => [
                'groupId' => '<string>',
            ],
            'user' => [
                'userId' => '<string>',
            ],
        ],
        // ...
    ],
    'parentDomainUnitId' => '<string>',
]

Result Details

Members
ancestorDomainUnitIds
Required: Yes
Type: Array of strings

The IDs of the ancestor domain units.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the domain unit was created.

createdBy
Type: string

The user who created the domain unit.

description
Type: string

The description of the domain unit.

domainId
Required: Yes
Type: string

The ID of the domain where the domain unit was created.

id
Required: Yes
Type: string

The ID of the domain unit.

name
Required: Yes
Type: string

The name of the domain unit.

owners
Required: Yes
Type: Array of DomainUnitOwnerProperties structures

The owners of the domain unit.

parentDomainUnitId
Type: string

The ID of the parent domain unit.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateEnvironment

$result = $client->createEnvironment([/* ... */]);
$promise = $client->createEnvironmentAsync([/* ... */]);

Create an Amazon DataZone environment.

Parameter Syntax

$result = $client->createEnvironment([
    'deploymentOrder' => <integer>,
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentAccountIdentifier' => '<string>',
    'environmentAccountRegion' => '<string>',
    'environmentBlueprintIdentifier' => '<string>',
    'environmentConfigurationId' => '<string>',
    'environmentProfileIdentifier' => '<string>', // REQUIRED
    'glossaryTerms' => ['<string>', ...],
    'name' => '<string>', // REQUIRED
    'projectIdentifier' => '<string>', // REQUIRED
    'userParameters' => [
        [
            'name' => '<string>',
            'value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Members
deploymentOrder
Type: int

The deployment order of the environment.

description
Type: string

The description of the Amazon DataZone environment.

domainIdentifier
Required: Yes
Type: string

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

environmentAccountIdentifier
Type: string

The ID of the account in which the environment is being created.

environmentAccountRegion
Type: string

The region of the account in which the environment is being created.

environmentBlueprintIdentifier
Type: string

The ID of the blueprint with which the environment is being created.

environmentConfigurationId
Type: string

The configuration ID of the environment.

environmentProfileIdentifier
Required: Yes
Type: string

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

glossaryTerms
Type: Array of strings

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

name
Required: Yes
Type: string

The name of the Amazon DataZone environment.

projectIdentifier
Required: Yes
Type: string

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

userParameters
Type: Array of EnvironmentParameter structures

The user parameters of this Amazon DataZone environment.

Result Syntax

[
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'deploymentProperties' => [
        'endTimeoutMinutes' => <integer>,
        'startTimeoutMinutes' => <integer>,
    ],
    '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>,
    'userParameters' => [
        [
            'defaultValue' => '<string>',
            'description' => '<string>',
            'fieldType' => '<string>',
            'isEditable' => true || false,
            'isOptional' => true || false,
            'keyName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

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

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the environment was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created this environment.

deploymentProperties
Type: DeploymentProperties structure

The deployment properties of this Amazon DataZone environment.

description
Type: string

The description of this Amazon DataZone environment.

domainId
Required: Yes
Type: string

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

environmentActions
Type: Array of ConfigurableEnvironmentAction structures

The configurable actions of this Amazon DataZone environment.

environmentBlueprintId
Type: string

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

environmentProfileId
Type: string

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

glossaryTerms
Type: Array of strings

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

id
Type: string

The ID of this Amazon DataZone environment.

lastDeployment
Type: Deployment structure

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

name
Required: Yes
Type: string

The name of this environment.

projectId
Required: Yes
Type: string

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

provider
Required: Yes
Type: string

The provider of this Amazon DataZone environment.

provisionedResources
Type: Array of Resource structures

The provisioned resources of this Amazon DataZone environment.

provisioningProperties
Type: ProvisioningProperties structure

The provisioning properties of this Amazon DataZone environment.

status
Type: string

The status of this Amazon DataZone environment.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this environment was updated.

userParameters
Type: Array of CustomParameter structures

The user parameters of this Amazon DataZone environment.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateEnvironmentAction

$result = $client->createEnvironmentAction([/* ... */]);
$promise = $client->createEnvironmentActionAsync([/* ... */]);

Creates an action for the environment, for example, creates a console link for an analytics tool that is available in this environment.

Parameter Syntax

$result = $client->createEnvironmentAction([
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'parameters' => [ // REQUIRED
        'awsConsoleLink' => [
            'uri' => '<string>',
        ],
    ],
]);

Parameter Details

Members
description
Type: string

The description of the environment action that is being created in the environment.

domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

The ID of the environment in which the environment action is created.

name
Required: Yes
Type: string

The name of the environment action.

parameters
Required: Yes
Type: ActionParameters structure

The parameters of the environment action.

Result Syntax

[
    'description' => '<string>',
    'domainId' => '<string>',
    'environmentId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'parameters' => [
        'awsConsoleLink' => [
            'uri' => '<string>',
        ],
    ],
]

Result Details

Members
description
Type: string

The description of the environment action.

domainId
Required: Yes
Type: string

The ID of the domain in which the environment action is created.

environmentId
Required: Yes
Type: string

The ID of the environment in which the environment is created.

id
Required: Yes
Type: string

The ID of the environment action.

name
Required: Yes
Type: string

The name of the environment action.

parameters
Required: Yes
Type: ActionParameters structure

The parameters of the environment action.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateEnvironmentProfile

$result = $client->createEnvironmentProfile([/* ... */]);
$promise = $client->createEnvironmentProfileAsync([/* ... */]);

Creates an Amazon DataZone environment profile.

Parameter Syntax

$result = $client->createEnvironmentProfile([
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentBlueprintIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'projectIdentifier' => '<string>', // REQUIRED
    'userParameters' => [
        [
            'name' => '<string>',
            'value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

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

description
Type: string

The description of this Amazon DataZone environment profile.

domainIdentifier
Required: Yes
Type: string

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

environmentBlueprintIdentifier
Required: Yes
Type: string

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

name
Required: Yes
Type: string

The name of this Amazon DataZone environment profile.

projectIdentifier
Required: Yes
Type: string

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

userParameters
Type: Array of EnvironmentParameter structures

The user parameters of this Amazon DataZone environment profile.

Result Syntax

[
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'environmentBlueprintId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'projectId' => '<string>',
    'updatedAt' => <DateTime>,
    'userParameters' => [
        [
            'defaultValue' => '<string>',
            'description' => '<string>',
            'fieldType' => '<string>',
            'isEditable' => true || false,
            'isOptional' => true || false,
            'keyName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

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

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this environment profile was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created this environment profile.

description
Type: string

The description of this Amazon DataZone environment profile.

domainId
Required: Yes
Type: string

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

environmentBlueprintId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The ID of this Amazon DataZone environment profile.

name
Required: Yes
Type: string

The name of this Amazon DataZone environment profile.

projectId
Type: string

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

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this environment profile was updated.

userParameters
Type: Array of CustomParameter structures

The user parameters of this Amazon DataZone environment profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateFormType

$result = $client->createFormType([/* ... */]);
$promise = $client->createFormTypeAsync([/* ... */]);

Creates a metadata form type.

Parameter Syntax

$result = $client->createFormType([
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'model' => [ // REQUIRED
        'smithy' => '<string>',
    ],
    'name' => '<string>', // REQUIRED
    'owningProjectIdentifier' => '<string>', // REQUIRED
    'status' => 'ENABLED|DISABLED',
]);

Parameter Details

Members
description
Type: string

The description of this Amazon DataZone metadata form type.

domainIdentifier
Required: Yes
Type: string

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

model
Required: Yes
Type: Model structure

The model of this Amazon DataZone metadata form type.

name
Required: Yes
Type: string

The name of this Amazon DataZone metadata form type.

owningProjectIdentifier
Required: Yes
Type: string

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

status
Type: string

The status of this Amazon DataZone metadata form type.

Result Syntax

[
    'description' => '<string>',
    'domainId' => '<string>',
    'name' => '<string>',
    'originDomainId' => '<string>',
    'originProjectId' => '<string>',
    'owningProjectId' => '<string>',
    'revision' => '<string>',
]

Result Details

Members
description
Type: string

The description of this Amazon DataZone metadata form type.

domainId
Required: Yes
Type: string

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

name
Required: Yes
Type: string

The name of this Amazon DataZone metadata form type.

originDomainId
Type: string

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

originProjectId
Type: string

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

owningProjectId
Type: string

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

revision
Required: Yes
Type: string

The revision of this Amazon DataZone metadata form type.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateGlossary

$result = $client->createGlossary([/* ... */]);
$promise = $client->createGlossaryAsync([/* ... */]);

Creates an Amazon DataZone business glossary.

Parameter Syntax

$result = $client->createGlossary([
    'clientToken' => '<string>',
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'owningProjectIdentifier' => '<string>', // REQUIRED
    'status' => 'DISABLED|ENABLED',
]);

Parameter Details

Members
clientToken
Type: string

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

description
Type: string

The description of this business glossary.

domainIdentifier
Required: Yes
Type: string

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

name
Required: Yes
Type: string

The name of this business glossary.

owningProjectIdentifier
Required: Yes
Type: string

The ID of the project that currently owns business glossary.

status
Type: string

The status of this business glossary.

Result Syntax

[
    'description' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'owningProjectId' => '<string>',
    'status' => 'DISABLED|ENABLED',
]

Result Details

Members
description
Type: string

The description of this business glossary.

domainId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The ID of this business glossary.

name
Required: Yes
Type: string

The name of this business glossary.

owningProjectId
Required: Yes
Type: string

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

status
Type: string

The status of this business glossary.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateGlossaryTerm

$result = $client->createGlossaryTerm([/* ... */]);
$promise = $client->createGlossaryTermAsync([/* ... */]);

Creates a business glossary term.

Parameter Syntax

$result = $client->createGlossaryTerm([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'glossaryIdentifier' => '<string>', // REQUIRED
    'longDescription' => '<string>',
    'name' => '<string>', // REQUIRED
    'shortDescription' => '<string>',
    'status' => 'ENABLED|DISABLED',
    'termRelations' => [
        'classifies' => ['<string>', ...],
        'isA' => ['<string>', ...],
    ],
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

glossaryIdentifier
Required: Yes
Type: string

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

longDescription
Type: string

The long description of this business glossary term.

name
Required: Yes
Type: string

The name of this business glossary term.

shortDescription
Type: string

The short description of this business glossary term.

status
Type: string

The status of this business glossary term.

termRelations
Type: TermRelations structure

The term relations of this business glossary term.

Result Syntax

[
    'domainId' => '<string>',
    'glossaryId' => '<string>',
    'id' => '<string>',
    'longDescription' => '<string>',
    'name' => '<string>',
    'shortDescription' => '<string>',
    'status' => 'ENABLED|DISABLED',
    'termRelations' => [
        'classifies' => ['<string>', ...],
        'isA' => ['<string>', ...],
    ],
]

Result Details

Members
domainId
Required: Yes
Type: string

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

glossaryId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The ID of this business glossary term.

longDescription
Type: string

The long description of this business glossary term.

name
Required: Yes
Type: string

The name of this business glossary term.

shortDescription
Type: string

The short description of this business glossary term.

status
Required: Yes
Type: string

The status of this business glossary term.

termRelations
Type: TermRelations structure

The term relations of this business glossary term.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateGroupProfile

$result = $client->createGroupProfile([/* ... */]);
$promise = $client->createGroupProfileAsync([/* ... */]);

Creates a group profile in Amazon DataZone.

Parameter Syntax

$result = $client->createGroupProfile([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'groupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

groupIdentifier
Required: Yes
Type: string

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

Result Syntax

[
    'domainId' => '<string>',
    'groupName' => '<string>',
    'id' => '<string>',
    'status' => 'ASSIGNED|NOT_ASSIGNED',
]

Result Details

Members
domainId
Type: string

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

groupName
Type: string

The name of the group for which group profile is created.

id
Type: string

The identifier of the group profile.

status
Type: string

The status of the group profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateListingChangeSet

$result = $client->createListingChangeSet([/* ... */]);
$promise = $client->createListingChangeSetAsync([/* ... */]);

Publishes a listing (a record of an asset at a given time) or removes a listing from the catalog.

Parameter Syntax

$result = $client->createListingChangeSet([
    'action' => 'PUBLISH|UNPUBLISH', // REQUIRED
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityRevision' => '<string>',
    'entityType' => 'ASSET|DATA_PRODUCT', // REQUIRED
]);

Parameter Details

Members
action
Required: Yes
Type: string

Specifies whether to publish or unpublish a listing.

clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain.

entityIdentifier
Required: Yes
Type: string

The ID of the asset.

entityRevision
Type: string

The revision of an asset.

entityType
Required: Yes
Type: string

The type of an entity.

Result Syntax

[
    'listingId' => '<string>',
    'listingRevision' => '<string>',
    'status' => 'CREATING|ACTIVE|INACTIVE',
]

Result Details

Members
listingId
Required: Yes
Type: string

The ID of the listing (a record of an asset at a given time).

listingRevision
Required: Yes
Type: string

The revision of a listing.

status
Required: Yes
Type: string

Specifies the status of the listing.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateProject

$result = $client->createProject([/* ... */]);
$promise = $client->createProjectAsync([/* ... */]);

Creates an Amazon DataZone project.

Parameter Syntax

$result = $client->createProject([
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'domainUnitId' => '<string>',
    'glossaryTerms' => ['<string>', ...],
    'name' => '<string>', // REQUIRED
    'projectProfileId' => '<string>',
    'userParameters' => [
        [
            'environmentConfigurationName' => '<string>',
            'environmentParameters' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
        ],
        // ...
    ],
]);

Parameter Details

Members
description
Type: string

The description of the Amazon DataZone project.

domainIdentifier
Required: Yes
Type: string

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

domainUnitId
Type: string

The ID of the domain unit. This parameter is not required and if it is not specified, then the project is created at the root domain unit level.

glossaryTerms
Type: Array of strings

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

name
Required: Yes
Type: string

The name of the Amazon DataZone project.

projectProfileId
Type: string

The ID of the project profile.

userParameters
Type: Array of EnvironmentConfigurationUserParameter structures

The user parameters of the project.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'environmentDeploymentDetails' => [
        'environmentFailureReasons' => [
            '<String>' => [
                [
                    'code' => '<string>',
                    'message' => '<string>',
                ],
                // ...
            ],
            // ...
        ],
        'overallDeploymentStatus' => 'PENDING_DEPLOYMENT|IN_PROGRESS|SUCCESSFUL|FAILED_VALIDATION|FAILED_DEPLOYMENT',
    ],
    'failureReasons' => [
        [
            'code' => '<string>',
            'message' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'projectProfileId' => '<string>',
    'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED',
    'userParameters' => [
        [
            'environmentConfigurationName' => '<string>',
            'environmentParameters' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
        ],
        // ...
    ],
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the project was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the project.

description
Type: string

The description of the project.

domainId
Required: Yes
Type: string

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

domainUnitId
Type: string

The ID of the domain unit.

environmentDeploymentDetails

The environment deployment details.

failureReasons
Type: Array of ProjectDeletionError structures

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

glossaryTerms
Type: Array of strings

The glossary terms that can be used in the project.

id
Required: Yes
Type: string

The ID of the Amazon DataZone project.

lastUpdatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the project was last updated.

name
Required: Yes
Type: string

The name of the project.

projectProfileId
Type: string

The project profile ID.

projectStatus
Type: string

The status of the Amazon DataZone project that was created.

userParameters
Type: Array of EnvironmentConfigurationUserParameter structures

The user parameters of the project.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateProjectMembership

$result = $client->createProjectMembership([/* ... */]);
$promise = $client->createProjectMembershipAsync([/* ... */]);

Creates a project membership in Amazon DataZone.

Parameter Syntax

$result = $client->createProjectMembership([
    'designation' => 'PROJECT_OWNER|PROJECT_CONTRIBUTOR|PROJECT_CATALOG_VIEWER|PROJECT_CATALOG_CONSUMER|PROJECT_CATALOG_STEWARD', // REQUIRED
    'domainIdentifier' => '<string>', // REQUIRED
    'member' => [ // REQUIRED
        'groupIdentifier' => '<string>',
        'userIdentifier' => '<string>',
    ],
    'projectIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
designation
Required: Yes
Type: string

The designation of the project membership.

domainIdentifier
Required: Yes
Type: string

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

member
Required: Yes
Type: Member structure

The project member whose project membership was created.

projectIdentifier
Required: Yes
Type: string

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

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateProjectProfile

$result = $client->createProjectProfile([/* ... */]);
$promise = $client->createProjectProfileAsync([/* ... */]);

Creates a project profile.

Parameter Syntax

$result = $client->createProjectProfile([
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'domainUnitIdentifier' => '<string>',
    'environmentConfigurations' => [
        [
            'awsAccount' => [ // REQUIRED
                'awsAccountId' => '<string>',
                'awsAccountIdPath' => '<string>',
            ],
            'awsRegion' => [ // REQUIRED
                'regionName' => '<string>',
                'regionNamePath' => '<string>',
            ],
            'configurationParameters' => [
                'parameterOverrides' => [
                    [
                        'isEditable' => true || false,
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'resolvedParameters' => [
                    [
                        'isEditable' => true || false,
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'ssmPath' => '<string>',
            ],
            'deploymentMode' => 'ON_CREATE|ON_DEMAND',
            'deploymentOrder' => <integer>,
            'description' => '<string>',
            'environmentBlueprintId' => '<string>', // REQUIRED
            'id' => '<string>',
            'name' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'name' => '<string>', // REQUIRED
    'status' => 'ENABLED|DISABLED',
]);

Parameter Details

Members
description
Type: string

A description of a project profile.

domainIdentifier
Required: Yes
Type: string

A domain ID of the project profile.

domainUnitIdentifier
Type: string

A domain unit ID of the project profile.

environmentConfigurations
Type: Array of EnvironmentConfiguration structures

Environment configurations of the project profile.

name
Required: Yes
Type: string

Project profile name.

status
Type: string

Project profile status.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'environmentConfigurations' => [
        [
            'awsAccount' => [
                'awsAccountId' => '<string>',
                'awsAccountIdPath' => '<string>',
            ],
            'awsRegion' => [
                'regionName' => '<string>',
                'regionNamePath' => '<string>',
            ],
            'configurationParameters' => [
                'parameterOverrides' => [
                    [
                        'isEditable' => true || false,
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'resolvedParameters' => [
                    [
                        'isEditable' => true || false,
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'ssmPath' => '<string>',
            ],
            'deploymentMode' => 'ON_CREATE|ON_DEMAND',
            'deploymentOrder' => <integer>,
            'description' => '<string>',
            'environmentBlueprintId' => '<string>',
            'id' => '<string>',
            'name' => '<string>',
        ],
        // ...
    ],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'status' => 'ENABLED|DISABLED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

A timestamp at which a project profile is created.

createdBy
Required: Yes
Type: string

A user who created a project profile.

description
Type: string

A project profile description.

domainId
Required: Yes
Type: string

The ID of the domain where a project profile is created.

domainUnitId
Type: string

The ID of the domain unit where a project profile is created.

environmentConfigurations
Type: Array of EnvironmentConfiguration structures

Environment configurations of a project profile.

id
Required: Yes
Type: string

Project profile ID.

lastUpdatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

A timestamp when a project profile was last updated.

name
Required: Yes
Type: string

Project profile name.

status
Type: string

Project profile status.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateRule

$result = $client->createRule([/* ... */]);
$promise = $client->createRuleAsync([/* ... */]);

Creates a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

Parameter Syntax

$result = $client->createRule([
    'action' => 'CREATE_SUBSCRIPTION_REQUEST', // REQUIRED
    'clientToken' => '<string>',
    'description' => '<string>',
    'detail' => [ // REQUIRED
        'metadataFormEnforcementDetail' => [
            'requiredMetadataForms' => [
                [
                    'typeIdentifier' => '<string>', // REQUIRED
                    'typeRevision' => '<string>', // REQUIRED
                ],
                // ...
            ],
        ],
    ],
    'domainIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'scope' => [ // REQUIRED
        'assetType' => [
            'selectionMode' => 'ALL|SPECIFIC', // REQUIRED
            'specificAssetTypes' => ['<string>', ...],
        ],
        'dataProduct' => true || false,
        'project' => [
            'selectionMode' => 'ALL|SPECIFIC', // REQUIRED
            'specificProjects' => ['<string>', ...],
        ],
    ],
    'target' => [ // REQUIRED
        'domainUnitTarget' => [
            'domainUnitId' => '<string>', // REQUIRED
            'includeChildDomainUnits' => true || false,
        ],
    ],
]);

Parameter Details

Members
action
Required: Yes
Type: string

The action of the rule.

clientToken
Type: string

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

description
Type: string

The description of the rule.

detail
Required: Yes
Type: RuleDetail structure

The detail of the rule.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where the rule is created.

name
Required: Yes
Type: string

The name of the rule.

scope
Required: Yes
Type: RuleScope structure

The scope of the rule.

target
Required: Yes
Type: RuleTarget structure

The target of the rule.

Result Syntax

[
    'action' => 'CREATE_SUBSCRIPTION_REQUEST',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'detail' => [
        'metadataFormEnforcementDetail' => [
            'requiredMetadataForms' => [
                [
                    'typeIdentifier' => '<string>',
                    'typeRevision' => '<string>',
                ],
                // ...
            ],
        ],
    ],
    'identifier' => '<string>',
    'name' => '<string>',
    'ruleType' => 'METADATA_FORM_ENFORCEMENT',
    'scope' => [
        'assetType' => [
            'selectionMode' => 'ALL|SPECIFIC',
            'specificAssetTypes' => ['<string>', ...],
        ],
        'dataProduct' => true || false,
        'project' => [
            'selectionMode' => 'ALL|SPECIFIC',
            'specificProjects' => ['<string>', ...],
        ],
    ],
    'target' => [
        'domainUnitTarget' => [
            'domainUnitId' => '<string>',
            'includeChildDomainUnits' => true || false,
        ],
    ],
    'targetType' => 'DOMAIN_UNIT',
]

Result Details

Members
action
Required: Yes
Type: string

The action of the rule.

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the rule is created.

createdBy
Required: Yes
Type: string

The user who creates the rule.

description
Type: string

The description of the rule.

detail
Required: Yes
Type: RuleDetail structure

The detail of the rule.

identifier
Required: Yes
Type: string

The ID of the rule.

name
Required: Yes
Type: string

The name of the rule.

ruleType
Required: Yes
Type: string

The type of the rule.

scope
Required: Yes
Type: RuleScope structure

The scope of the rule.

target
Required: Yes
Type: RuleTarget structure

The target of the rule.

targetType
Type: string

The target type of the rule.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateSubscriptionGrant

$result = $client->createSubscriptionGrant([/* ... */]);
$promise = $client->createSubscriptionGrantAsync([/* ... */]);

Creates a subsscription grant in Amazon DataZone.

Parameter Syntax

$result = $client->createSubscriptionGrant([
    'assetTargetNames' => [
        [
            'assetId' => '<string>', // REQUIRED
            'targetName' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'grantedEntity' => [ // REQUIRED
        'listing' => [
            'identifier' => '<string>', // REQUIRED
            'revision' => '<string>', // REQUIRED
        ],
    ],
    'subscriptionTargetIdentifier' => '<string>',
]);

Parameter Details

Members
assetTargetNames
Type: Array of AssetTargetNameMap structures

The names of the assets for which the subscription grant is created.

clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

The ID of the environment in which the subscription grant is created.

grantedEntity
Required: Yes
Type: GrantedEntityInput structure

The entity to which the subscription is to be granted.

subscriptionTargetIdentifier
Type: string

The ID of the subscription target for which the subscription grant is created.

Result Syntax

[
    'assets' => [
        [
            'assetId' => '<string>',
            'assetRevision' => '<string>',
            'assetScope' => [
                'assetId' => '<string>',
                'errorMessage' => '<string>',
                'filterIds' => ['<string>', ...],
                'status' => '<string>',
            ],
            'failureCause' => [
                'message' => '<string>',
            ],
            'failureTimestamp' => <DateTime>,
            'grantedTimestamp' => <DateTime>,
            'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED',
            'targetName' => '<string>',
        ],
        // ...
    ],
    'createdAt' => <DateTime>,
    '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>,
    'updatedBy' => '<string>',
]

Result Details

Members
assets
Type: Array of SubscribedAsset structures

The assets for which the subscription grant is created.

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

A timestamp of when the subscription grant is created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription grant.

domainId
Required: Yes
Type: string

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

grantedEntity
Required: Yes
Type: GrantedEntity structure

The entity to which the subscription is granted.

id
Required: Yes
Type: string

The ID of the subscription grant.

status
Required: Yes
Type: string

The status of the subscription grant.

subscriptionId
Type: string

The identifier of the subscription grant.

subscriptionTargetId
Required: Yes
Type: string

The ID of the subscription target for which the subscription grant is created.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

A timestamp of when the subscription grant was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription grant.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateSubscriptionRequest

$result = $client->createSubscriptionRequest([/* ... */]);
$promise = $client->createSubscriptionRequestAsync([/* ... */]);

Creates a subscription request in Amazon DataZone.

Parameter Syntax

$result = $client->createSubscriptionRequest([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'metadataForms' => [
        [
            'content' => '<string>',
            'formName' => '<string>', // REQUIRED
            'typeIdentifier' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'requestReason' => '<string>', // REQUIRED
    'subscribedListings' => [ // REQUIRED
        [
            'identifier' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'subscribedPrincipals' => [ // REQUIRED
        [
            'project' => [
                'identifier' => '<string>',
            ],
        ],
        // ...
    ],
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which the subscription request is created.

metadataForms
Type: Array of FormInput structures

The metadata form included in the subscription request.

requestReason
Required: Yes
Type: string

The reason for the subscription request.

subscribedListings
Required: Yes
Type: Array of SubscribedListingInput structures

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

subscribedPrincipals
Required: Yes
Type: Array of SubscribedPrincipalInput structures

The Amazon DataZone principals for whom the subscription request is created.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'decisionComment' => '<string>',
    'domainId' => '<string>',
    'existingSubscriptionId' => '<string>',
    'id' => '<string>',
    'metadataForms' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'requestReason' => '<string>',
    'reviewerId' => '<string>',
    'status' => 'PENDING|ACCEPTED|REJECTED',
    'subscribedListings' => [
        [
            'description' => '<string>',
            'id' => '<string>',
            'item' => [
                'assetListing' => [
                    'assetScope' => [
                        'assetId' => '<string>',
                        'errorMessage' => '<string>',
                        'filterIds' => ['<string>', ...],
                        'status' => '<string>',
                    ],
                    'entityId' => '<string>',
                    'entityRevision' => '<string>',
                    'entityType' => '<string>',
                    'forms' => '<string>',
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                ],
                'productListing' => [
                    'assetListings' => [
                        [
                            'entityId' => '<string>',
                            'entityRevision' => '<string>',
                            'entityType' => '<string>',
                        ],
                        // ...
                    ],
                    'description' => '<string>',
                    'entityId' => '<string>',
                    'entityRevision' => '<string>',
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                    'name' => '<string>',
                ],
            ],
            'name' => '<string>',
            'ownerProjectId' => '<string>',
            'ownerProjectName' => '<string>',
            'revision' => '<string>',
        ],
        // ...
    ],
    'subscribedPrincipals' => [
        [
            'project' => [
                'id' => '<string>',
                'name' => '<string>',
            ],
        ],
        // ...
    ],
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

A timestamp of when the subscription request is created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription request.

decisionComment
Type: string

The decision comment of the subscription request.

domainId
Required: Yes
Type: string

The ID of the Amazon DataZone domain in whcih the subscription request is created.

existingSubscriptionId
Type: string

The ID of the existing subscription.

id
Required: Yes
Type: string

The ID of the subscription request.

metadataForms
Type: Array of FormOutput structures

The metadata form included in the subscription request.

requestReason
Required: Yes
Type: string

The reason for the subscription request.

reviewerId
Type: string

The ID of the reviewer of the subscription request.

status
Required: Yes
Type: string

The status of the subscription request.

subscribedListings
Required: Yes
Type: Array of SubscribedListing structures

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

subscribedPrincipals
Required: Yes
Type: Array of SubscribedPrincipal structures

The subscribed principals of the subscription request.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription request was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription request.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateSubscriptionTarget

$result = $client->createSubscriptionTarget([/* ... */]);
$promise = $client->createSubscriptionTargetAsync([/* ... */]);

Creates a subscription target in Amazon DataZone.

Parameter Syntax

$result = $client->createSubscriptionTarget([
    'applicableAssetTypes' => ['<string>', ...], // REQUIRED
    'authorizedPrincipals' => ['<string>', ...], // REQUIRED
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'manageAccessRole' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'provider' => '<string>',
    'subscriptionTargetConfig' => [ // REQUIRED
        [
            'content' => '<string>', // REQUIRED
            'formName' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'type' => '<string>', // REQUIRED
]);

Parameter Details

Members
applicableAssetTypes
Required: Yes
Type: Array of strings

The asset types that can be included in the subscription target.

authorizedPrincipals
Required: Yes
Type: Array of strings

The authorized principals of the subscription target.

clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

The ID of the environment in which subscription target is created.

manageAccessRole
Required: Yes
Type: string

The manage access role that is used to create the subscription target.

name
Required: Yes
Type: string

The name of the subscription target.

provider
Type: string

The provider of the subscription target.

subscriptionTargetConfig
Required: Yes
Type: Array of SubscriptionTargetForm structures

The configuration of the subscription target.

type
Required: Yes
Type: string

The type of the subscription target.

Result Syntax

[
    'applicableAssetTypes' => ['<string>', ...],
    'authorizedPrincipals' => ['<string>', ...],
    'createdAt' => <DateTime>,
    '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>,
    'updatedBy' => '<string>',
]

Result Details

Members
applicableAssetTypes
Required: Yes
Type: Array of strings

The asset types that can be included in the subscription target.

authorizedPrincipals
Required: Yes
Type: Array of strings

The authorised principals of the subscription target.

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription target was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription target.

domainId
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which the subscription target was created.

environmentId
Required: Yes
Type: string

The ID of the environment in which the subscription target was created.

id
Required: Yes
Type: string

The ID of the subscription target.

manageAccessRole
Type: string

The manage access role with which the subscription target was created.

name
Required: Yes
Type: string

The name of the subscription target.

projectId
Required: Yes
Type: string

???

provider
Required: Yes
Type: string

The provider of the subscription target.

subscriptionTargetConfig
Required: Yes
Type: Array of SubscriptionTargetForm structures

The configuration of the subscription target.

type
Required: Yes
Type: string

The type of the subscription target.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription target was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription target.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

CreateUserProfile

$result = $client->createUserProfile([/* ... */]);
$promise = $client->createUserProfileAsync([/* ... */]);

Creates a user profile in Amazon DataZone.

Parameter Syntax

$result = $client->createUserProfile([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'userIdentifier' => '<string>', // REQUIRED
    'userType' => 'IAM_USER|IAM_ROLE|SSO_USER',
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

userIdentifier
Required: Yes
Type: string

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

userType
Type: string

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

Result 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',
]

Result Details

Members
details
Type: UserProfileDetails structure

The details of the user profile in Amazon DataZone.

domainId
Type: string

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

id
Type: string

The identifier of the user profile.

status
Type: string

The status of the user profile.

type
Type: string

The type of the user profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteAsset

$result = $client->deleteAsset([/* ... */]);
$promise = $client->deleteAssetAsync([/* ... */]);

Deletes an asset in Amazon DataZone.

Parameter Syntax

$result = $client->deleteAsset([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the asset that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteAssetFilter

$result = $client->deleteAssetFilter([/* ... */]);
$promise = $client->deleteAssetFilterAsync([/* ... */]);

Deletes an asset filter.

Parameter Syntax

$result = $client->deleteAssetFilter([
    'assetIdentifier' => '<string>', // REQUIRED
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
assetIdentifier
Required: Yes
Type: string

The ID of the data asset.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to delete an asset filter.

identifier
Required: Yes
Type: string

The ID of the asset filter that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteAssetType

$result = $client->deleteAssetType([/* ... */]);
$promise = $client->deleteAssetTypeAsync([/* ... */]);

Deletes an asset type in Amazon DataZone.

Parameter Syntax

$result = $client->deleteAssetType([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the asset type that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteConnection

$result = $client->deleteConnection([/* ... */]);
$promise = $client->deleteConnectionAsync([/* ... */]);

Deletes and connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.

Parameter Syntax

$result = $client->deleteConnection([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where the connection is deleted.

identifier
Required: Yes
Type: string

The ID of the connection that is deleted.

Result Syntax

[
    'status' => '<string>',
]

Result Details

Members
status
Type: string

The status of the action.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteDataProduct

$result = $client->deleteDataProduct([/* ... */]);
$promise = $client->deleteDataProductAsync([/* ... */]);

Deletes a data product in Amazon DataZone.

Parameter Syntax

$result = $client->deleteDataProduct([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the data product that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteDataSource

$result = $client->deleteDataSource([/* ... */]);
$promise = $client->deleteDataSourceAsync([/* ... */]);

Deletes a data source in Amazon DataZone.

Parameter Syntax

$result = $client->deleteDataSource([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'retainPermissionsOnRevokeFailure' => true || false,
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the data source that is deleted.

retainPermissionsOnRevokeFailure
Type: boolean

Specifies that the granted permissions are retained in case of a self-subscribe functionality failure for a data source.

Result Syntax

[
    'assetFormsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'configuration' => [
        'glueRunConfiguration' => [
            'accountId' => '<string>',
            'autoImportDataQualityResult' => true || false,
            'catalogName' => '<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>',
                ],
                // ...
            ],
        ],
        'sageMakerRunConfiguration' => [
            'accountId' => '<string>',
            'region' => '<string>',
            'trackingAssets' => [
                '<SageMakerAssetType>' => ['<string>', ...],
                // ...
            ],
        ],
    ],
    'connectionId' => '<string>',
    'createdAt' => <DateTime>,
    '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>,
    '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,
    'retainPermissionsOnRevokeFailure' => 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',
    ],
    'selfGrantStatus' => [
        'glueSelfGrantStatus' => [
            'selfGrantStatusDetails' => [
                [
                    'databaseName' => '<string>',
                    'failureCause' => '<string>',
                    'schemaName' => '<string>',
                    'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED',
                ],
                // ...
            ],
        ],
        'redshiftSelfGrantStatus' => [
            'selfGrantStatusDetails' => [
                [
                    'databaseName' => '<string>',
                    'failureCause' => '<string>',
                    'schemaName' => '<string>',
                    'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED',
                ],
                // ...
            ],
        ],
    ],
    'status' => 'CREATING|FAILED_CREATION|READY|UPDATING|FAILED_UPDATE|RUNNING|DELETING|FAILED_DELETION',
    'type' => '<string>',
    'updatedAt' => <DateTime>,
]

Result Details

Members
assetFormsOutput
Type: Array of FormOutput structures

The asset data forms associated with this data source.

configuration

The configuration of the data source that is deleted.

connectionId
Type: string

The ID of the connection that is deleted.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this data source was created.

description
Type: string

The description of the data source that is deleted.

domainId
Required: Yes
Type: string

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

enableSetting
Type: string

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

environmentId
Type: string

The ID of the environemnt associated with this data source.

errorMessage
Type: DataSourceErrorMessage structure

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

id
Required: Yes
Type: string

The ID of the data source that is deleted.

lastRunAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the data source was last run.

lastRunErrorMessage
Type: DataSourceErrorMessage structure

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

lastRunStatus
Type: string

The status of the last run of this data source.

name
Required: Yes
Type: string

The name of the data source that is deleted.

projectId
Required: Yes
Type: string

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

publishOnImport
Type: boolean

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

retainPermissionsOnRevokeFailure
Type: boolean

Specifies that the granted permissions are retained in case of a self-subscribe functionality failure for a data source.

schedule
Type: ScheduleConfiguration structure

The schedule of runs for this data source.

selfGrantStatus
Type: SelfGrantStatusOutput structure

Specifies the status of the self-granting functionality.

status
Type: string

The status of this data source.

type
Type: string

The type of this data source.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this data source was updated.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteDomain

$result = $client->deleteDomain([/* ... */]);
$promise = $client->deleteDomainAsync([/* ... */]);

Deletes a Amazon DataZone domain.

Parameter Syntax

$result = $client->deleteDomain([
    'clientToken' => '<string>',
    'identifier' => '<string>', // REQUIRED
    'skipDeletionCheck' => true || false,
]);

Parameter Details

Members
clientToken
Type: string

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

identifier
Required: Yes
Type: string

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

skipDeletionCheck
Type: boolean

Specifies the optional flag to delete all child entities within the domain.

Result Syntax

[
    'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED',
]

Result Details

Members
status
Required: Yes
Type: string

The status of the domain.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteDomainUnit

$result = $client->deleteDomainUnit([/* ... */]);
$promise = $client->deleteDomainUnitAsync([/* ... */]);

Deletes a domain unit.

Parameter Syntax

$result = $client->deleteDomainUnit([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to delete a domain unit.

identifier
Required: Yes
Type: string

The ID of the domain unit that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteEnvironment

$result = $client->deleteEnvironment([/* ... */]);
$promise = $client->deleteEnvironmentAsync([/* ... */]);

Deletes an environment in Amazon DataZone.

Parameter Syntax

$result = $client->deleteEnvironment([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the environment that is to be deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteEnvironmentAction

$result = $client->deleteEnvironmentAction([/* ... */]);
$promise = $client->deleteEnvironmentActionAsync([/* ... */]);

Deletes an action for the environment, for example, deletes a console link for an analytics tool that is available in this environment.

Parameter Syntax

$result = $client->deleteEnvironmentAction([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

The ID of the environment where an environment action is deleted.

identifier
Required: Yes
Type: string

The ID of the environment action that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteEnvironmentBlueprintConfiguration

$result = $client->deleteEnvironmentBlueprintConfiguration([/* ... */]);
$promise = $client->deleteEnvironmentBlueprintConfigurationAsync([/* ... */]);

Deletes the blueprint configuration in Amazon DataZone.

Parameter Syntax

$result = $client->deleteEnvironmentBlueprintConfiguration([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentBlueprintIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentBlueprintIdentifier
Required: Yes
Type: string

The ID of the blueprint the configuration of which is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteEnvironmentProfile

$result = $client->deleteEnvironmentProfile([/* ... */]);
$promise = $client->deleteEnvironmentProfileAsync([/* ... */]);

Deletes an environment profile in Amazon DataZone.

Parameter Syntax

$result = $client->deleteEnvironmentProfile([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the environment profile that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteFormType

$result = $client->deleteFormType([/* ... */]);
$promise = $client->deleteFormTypeAsync([/* ... */]);

Delets and metadata form type in Amazon DataZone.

Parameter Syntax

$result = $client->deleteFormType([
    'domainIdentifier' => '<string>', // REQUIRED
    'formTypeIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

formTypeIdentifier
Required: Yes
Type: string

The ID of the metadata form type that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteGlossary

$result = $client->deleteGlossary([/* ... */]);
$promise = $client->deleteGlossaryAsync([/* ... */]);

Deletes a business glossary in Amazon DataZone.

Parameter Syntax

$result = $client->deleteGlossary([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the business glossary that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteGlossaryTerm

$result = $client->deleteGlossaryTerm([/* ... */]);
$promise = $client->deleteGlossaryTermAsync([/* ... */]);

Deletes a business glossary term in Amazon DataZone.

Parameter Syntax

$result = $client->deleteGlossaryTerm([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the business glossary term that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteListing

$result = $client->deleteListing([/* ... */]);
$promise = $client->deleteListingAsync([/* ... */]);

Deletes a listing (a record of an asset at a given time).

Parameter Syntax

$result = $client->deleteListing([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain.

identifier
Required: Yes
Type: string

The ID of the listing to be deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteProject

$result = $client->deleteProject([/* ... */]);
$promise = $client->deleteProjectAsync([/* ... */]);

Deletes a project in Amazon DataZone.

Parameter Syntax

$result = $client->deleteProject([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'skipDeletionCheck' => true || false,
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the project that is to be deleted.

skipDeletionCheck
Type: boolean

Specifies the optional flag to delete all child entities within the project.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteProjectMembership

$result = $client->deleteProjectMembership([/* ... */]);
$promise = $client->deleteProjectMembershipAsync([/* ... */]);

Deletes project membership in Amazon DataZone.

Parameter Syntax

$result = $client->deleteProjectMembership([
    'domainIdentifier' => '<string>', // REQUIRED
    'member' => [ // REQUIRED
        'groupIdentifier' => '<string>',
        'userIdentifier' => '<string>',
    ],
    'projectIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

member
Required: Yes
Type: Member structure

The project member whose project membership is deleted.

projectIdentifier
Required: Yes
Type: string

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

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteProjectProfile

$result = $client->deleteProjectProfile([/* ... */]);
$promise = $client->deleteProjectProfileAsync([/* ... */]);

Deletes a project profile.

Parameter Syntax

$result = $client->deleteProjectProfile([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where a project profile is deleted.

identifier
Required: Yes
Type: string

The ID of the project profile that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteRule

$result = $client->deleteRule([/* ... */]);
$promise = $client->deleteRuleAsync([/* ... */]);

Deletes a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

Parameter Syntax

$result = $client->deleteRule([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain that where the rule is to be deleted.

identifier
Required: Yes
Type: string

The ID of the rule that is to be deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteSubscriptionGrant

$result = $client->deleteSubscriptionGrant([/* ... */]);
$promise = $client->deleteSubscriptionGrantAsync([/* ... */]);

Deletes and subscription grant in Amazon DataZone.

Parameter Syntax

$result = $client->deleteSubscriptionGrant([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the subscription grant that is deleted.

Result Syntax

[
    'assets' => [
        [
            'assetId' => '<string>',
            'assetRevision' => '<string>',
            'assetScope' => [
                'assetId' => '<string>',
                'errorMessage' => '<string>',
                'filterIds' => ['<string>', ...],
                'status' => '<string>',
            ],
            'failureCause' => [
                'message' => '<string>',
            ],
            'failureTimestamp' => <DateTime>,
            'grantedTimestamp' => <DateTime>,
            'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED',
            'targetName' => '<string>',
        ],
        // ...
    ],
    'createdAt' => <DateTime>,
    '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>,
    'updatedBy' => '<string>',
]

Result Details

Members
assets
Type: Array of SubscribedAsset structures

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

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

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

createdBy
Required: Yes
Type: string

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

domainId
Required: Yes
Type: string

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

grantedEntity
Required: Yes
Type: GrantedEntity structure

The entity to which the subscription is deleted.

id
Required: Yes
Type: string

The ID of the subscription grant that is deleted.

status
Required: Yes
Type: string

The status of the subscription grant that is deleted.

subscriptionId
Type: string

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

subscriptionTargetId
Required: Yes
Type: string

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

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

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

updatedBy
Type: string

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

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteSubscriptionRequest

$result = $client->deleteSubscriptionRequest([/* ... */]);
$promise = $client->deleteSubscriptionRequestAsync([/* ... */]);

Deletes a subscription request in Amazon DataZone.

Parameter Syntax

$result = $client->deleteSubscriptionRequest([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the subscription request that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteSubscriptionTarget

$result = $client->deleteSubscriptionTarget([/* ... */]);
$promise = $client->deleteSubscriptionTargetAsync([/* ... */]);

Deletes a subscription target in Amazon DataZone.

Parameter Syntax

$result = $client->deleteSubscriptionTarget([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the subscription target that is deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DeleteTimeSeriesDataPoints

$result = $client->deleteTimeSeriesDataPoints([/* ... */]);
$promise = $client->deleteTimeSeriesDataPointsAsync([/* ... */]);

Deletes the specified time series form for the specified asset.

Parameter Syntax

$result = $client->deleteTimeSeriesDataPoints([
    'clientToken' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityType' => 'ASSET|LISTING', // REQUIRED
    'formName' => '<string>', // REQUIRED
]);

Parameter Details

Members
clientToken
Type: string

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

domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain that houses the asset for which you want to delete a time series form.

entityIdentifier
Required: Yes
Type: string

The ID of the asset for which you want to delete a time series form.

entityType
Required: Yes
Type: string

The type of the asset for which you want to delete a time series form.

formName
Required: Yes
Type: string

The name of the time series form that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

DisassociateEnvironmentRole

$result = $client->disassociateEnvironmentRole([/* ... */]);
$promise = $client->disassociateEnvironmentRoleAsync([/* ... */]);

Disassociates the environment role in Amazon DataZone.

Parameter Syntax

$result = $client->disassociateEnvironmentRole([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'environmentRoleArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which an environment role is disassociated.

environmentIdentifier
Required: Yes
Type: string

The ID of the environment.

environmentRoleArn
Required: Yes
Type: string

The ARN of the environment role.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetAsset

$result = $client->getAsset([/* ... */]);
$promise = $client->getAssetAsync([/* ... */]);

Gets an Amazon DataZone asset.

Parameter Syntax

$result = $client->getAsset([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'revision' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain to which the asset belongs.

identifier
Required: Yes
Type: string

The ID of the Amazon DataZone asset.

revision
Type: string

The revision of the Amazon DataZone asset.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'externalIdentifier' => '<string>',
    'firstRevisionCreatedAt' => <DateTime>,
    'firstRevisionCreatedBy' => '<string>',
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'latestTimeSeriesDataPointFormsOutput' => [
        [
            'contentSummary' => '<string>',
            'formName' => '<string>',
            'id' => '<string>',
            'timestamp' => <DateTime>,
            'typeIdentifier' => '<string>',
            'typeRevision' => '<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>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the asset was created.

createdBy
Type: string

The Amazon DataZone user who created the asset.

description
Type: string

The description of the Amazon DataZone asset.

domainId
Required: Yes
Type: string

The ID of the Amazon DataZone domain to which the asset belongs.

externalIdentifier
Type: string

The external ID of the asset.

firstRevisionCreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the first revision of the asset was created.

firstRevisionCreatedBy
Type: string

The Amazon DataZone user who created the first revision of the asset.

formsOutput
Required: Yes
Type: Array of FormOutput structures

The metadata forms attached to the asset.

glossaryTerms
Type: Array of strings

The business glossary terms attached to the asset.

id
Required: Yes
Type: string

The ID of the asset.

latestTimeSeriesDataPointFormsOutput
Type: Array of TimeSeriesDataPointSummaryFormOutput structures

The latest data point that was imported into the time series form for the asset.

listing
Type: AssetListingDetails structure

The listing of the asset.

name
Required: Yes
Type: string

The name of the asset.

owningProjectId
Required: Yes
Type: string

The ID of the project that owns the asset.

readOnlyFormsOutput
Type: Array of FormOutput structures

The read-only metadata forms attached to the asset.

revision
Required: Yes
Type: string

The revision of the asset.

typeIdentifier
Required: Yes
Type: string

The ID of the asset type.

typeRevision
Required: Yes
Type: string

The revision of the asset type.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetAssetFilter

$result = $client->getAssetFilter([/* ... */]);
$promise = $client->getAssetFilterAsync([/* ... */]);

Gets an asset filter.

Parameter Syntax

$result = $client->getAssetFilter([
    'assetIdentifier' => '<string>', // REQUIRED
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
assetIdentifier
Required: Yes
Type: string

The ID of the data asset.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to get an asset filter.

identifier
Required: Yes
Type: string

The ID of the asset filter.

Result Syntax

[
    'assetId' => '<string>',
    'configuration' => [
        'columnConfiguration' => [
            'includedColumnNames' => ['<string>', ...],
        ],
        'rowConfiguration' => [
            'rowFilter' => [
                'and' => [
                    [...], // RECURSIVE
                    // ...
                ],
                'expression' => [
                    'equalTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'greaterThan' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'greaterThanOrEqualTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'in' => [
                        'columnName' => '<string>',
                        'values' => ['<string>', ...],
                    ],
                    'isNotNull' => [
                        'columnName' => '<string>',
                    ],
                    'isNull' => [
                        'columnName' => '<string>',
                    ],
                    'lessThan' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'lessThanOrEqualTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'like' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'notEqualTo' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                    'notIn' => [
                        'columnName' => '<string>',
                        'values' => ['<string>', ...],
                    ],
                    'notLike' => [
                        'columnName' => '<string>',
                        'value' => '<string>',
                    ],
                ],
                'or' => [
                    [...], // RECURSIVE
                    // ...
                ],
            ],
            'sensitive' => true || false,
        ],
    ],
    'createdAt' => <DateTime>,
    'description' => '<string>',
    'domainId' => '<string>',
    'effectiveColumnNames' => ['<string>', ...],
    'effectiveRowFilter' => '<string>',
    'errorMessage' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'status' => 'VALID|INVALID',
]

Result Details

Members
assetId
Required: Yes
Type: string

The ID of the data asset.

configuration
Required: Yes
Type: AssetFilterConfiguration structure

The configuration of the asset filter.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the asset filter was created.

description
Type: string

The description of the asset filter.

domainId
Required: Yes
Type: string

The ID of the domain where you want to get an asset filter.

effectiveColumnNames
Type: Array of strings

The column names of the asset filter.

effectiveRowFilter
Type: string

The row filter of the asset filter.

errorMessage
Type: string

The error message that is displayed if the action does not complete successfully.

id
Required: Yes
Type: string

The ID of the asset filter.

name
Required: Yes
Type: string

The name of the asset filter.

status
Type: string

The status of the asset filter.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetAssetType

$result = $client->getAssetType([/* ... */]);
$promise = $client->getAssetTypeAsync([/* ... */]);

Gets an Amazon DataZone asset type.

Parameter Syntax

$result = $client->getAssetType([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'revision' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the asset type.

revision
Type: string

The revision of the asset type.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'formsOutput' => [
        '<FormName>' => [
            'required' => true || false,
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>',
    'originDomainId' => '<string>',
    'originProjectId' => '<string>',
    'owningProjectId' => '<string>',
    'revision' => '<string>',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the asset type was created.

createdBy
Type: string

The Amazon DataZone user who created the asset type.

description
Type: string

The description of the asset type.

domainId
Required: Yes
Type: string

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

formsOutput
Required: Yes
Type: Associative array of custom strings keys (FormName) to FormEntryOutput structures

The metadata forms attached to the asset type.

name
Required: Yes
Type: string

The name of the asset type.

originDomainId
Type: string

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

originProjectId
Type: string

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

owningProjectId
Required: Yes
Type: string

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

revision
Required: Yes
Type: string

The revision of the asset type.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the asset type was updated.

updatedBy
Type: string

The Amazon DataZone user that updated the asset type.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetConnection

$result = $client->getConnection([/* ... */]);
$promise = $client->getConnectionAsync([/* ... */]);

Gets a connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.

Parameter Syntax

$result = $client->getConnection([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'withSecret' => true || false,
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where we get the connection.

identifier
Required: Yes
Type: string

The connection ID.

withSecret
Type: boolean

Specifies whether a connection has a secret.

Result Syntax

[
    'connectionCredentials' => [
        'accessKeyId' => '<string>',
        'expiration' => <DateTime>,
        'secretAccessKey' => '<string>',
        'sessionToken' => '<string>',
    ],
    'connectionId' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'environmentId' => '<string>',
    'environmentUserRole' => '<string>',
    'name' => '<string>',
    'physicalEndpoints' => [
        [
            'awsLocation' => [
                'accessRole' => '<string>',
                'awsAccountId' => '<string>',
                'awsRegion' => '<string>',
                'iamConnectionId' => '<string>',
            ],
            'glueConnection' => [
                'athenaProperties' => ['<string>', ...],
                'authenticationConfiguration' => [
                    'authenticationType' => 'BASIC|OAUTH2|CUSTOM',
                    'oAuth2Properties' => [
                        'authorizationCodeProperties' => [
                            'authorizationCode' => '<string>',
                            'redirectUri' => '<string>',
                        ],
                        'oAuth2ClientApplication' => [
                            'aWSManagedClientApplicationReference' => '<string>',
                            'userManagedClientApplicationClientId' => '<string>',
                        ],
                        'oAuth2Credentials' => [
                            'accessToken' => '<string>',
                            'jwtToken' => '<string>',
                            'refreshToken' => '<string>',
                            'userManagedClientApplicationClientSecret' => '<string>',
                        ],
                        'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER',
                        'tokenUrl' => '<string>',
                        'tokenUrlParametersMap' => ['<string>', ...],
                    ],
                    'secretArn' => '<string>',
                ],
                'compatibleComputeEnvironments' => ['<string>', ...],
                'connectionProperties' => ['<string>', ...],
                'connectionSchemaVersion' => <integer>,
                'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
                'creationTime' => <DateTime>,
                'description' => '<string>',
                'lastConnectionValidationTime' => <DateTime>,
                'lastUpdatedBy' => '<string>',
                'lastUpdatedTime' => <DateTime>,
                'matchCriteria' => ['<string>', ...],
                'name' => '<string>',
                'physicalConnectionRequirements' => [
                    'availabilityZone' => '<string>',
                    'securityGroupIdList' => ['<string>', ...],
                    'subnetId' => '<string>',
                    'subnetIdList' => ['<string>', ...],
                ],
                'pythonProperties' => ['<string>', ...],
                'sparkProperties' => ['<string>', ...],
                'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
                'statusReason' => '<string>',
            ],
            'glueConnectionName' => '<string>',
            'host' => '<string>',
            'port' => <integer>,
            'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM',
            'stage' => '<string>',
        ],
        // ...
    ],
    'projectId' => '<string>',
    'props' => [
        'athenaProperties' => [
            'workgroupName' => '<string>',
        ],
        'glueProperties' => [
            'errorMessage' => '<string>',
            'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
        ],
        'hyperPodProperties' => [
            'clusterArn' => '<string>',
            'clusterName' => '<string>',
            'orchestrator' => 'EKS|SLURM',
        ],
        'iamProperties' => [
            'environmentId' => '<string>',
            'glueLineageSyncEnabled' => true || false,
        ],
        'redshiftProperties' => [
            'credentials' => [
                'secretArn' => '<string>',
                'usernamePassword' => [
                    'password' => '<string>',
                    'username' => '<string>',
                ],
            ],
            'databaseName' => '<string>',
            'isProvisionedSecret' => true || false,
            'jdbcIamUrl' => '<string>',
            'jdbcUrl' => '<string>',
            'lineageSync' => [
                'enabled' => true || false,
                'lineageJobId' => '<string>',
                'schedule' => [
                    'schedule' => '<string>',
                ],
            ],
            'redshiftTempDir' => '<string>',
            'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
            'storage' => [
                'clusterName' => '<string>',
                'workgroupName' => '<string>',
            ],
        ],
        'sparkEmrProperties' => [
            'computeArn' => '<string>',
            'credentials' => [
                'password' => '<string>',
                'username' => '<string>',
            ],
            'credentialsExpiration' => <DateTime>,
            'governanceType' => 'AWS_MANAGED|USER_MANAGED',
            'instanceProfileArn' => '<string>',
            'javaVirtualEnv' => '<string>',
            'livyEndpoint' => '<string>',
            'logUri' => '<string>',
            'pythonVirtualEnv' => '<string>',
            'runtimeRole' => '<string>',
            'trustedCertificatesS3Uri' => '<string>',
        ],
        'sparkGlueProperties' => [
            'additionalArgs' => [
                'connection' => '<string>',
            ],
            'glueConnectionName' => '<string>',
            'glueVersion' => '<string>',
            'idleTimeout' => <integer>,
            'javaVirtualEnv' => '<string>',
            'numberOfWorkers' => <integer>,
            'pythonVirtualEnv' => '<string>',
            'workerType' => '<string>',
        ],
    ],
    'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
]

Result Details

Members
connectionCredentials
Type: ConnectionCredentials structure

Connection credentials.

connectionId
Required: Yes
Type: string

The ID of the connection.

description
Type: string

Connection description.

domainId
Required: Yes
Type: string

The domain ID of the connection.

domainUnitId
Required: Yes
Type: string

The domain unit ID of the connection.

environmentId
Type: string

The ID of the environment.

environmentUserRole
Type: string

The environment user role.

name
Required: Yes
Type: string

The name of the connection.

physicalEndpoints
Required: Yes
Type: Array of PhysicalEndpoint structures

The physical endpoints of the connection.

projectId
Type: string

The ID of the project.

props
Type: ConnectionPropertiesOutput structure

Connection props.

type
Required: Yes
Type: string

The type of the connection.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetDataProduct

$result = $client->getDataProduct([/* ... */]);
$promise = $client->getDataProductAsync([/* ... */]);

Gets the data product.

Parameter Syntax

$result = $client->getDataProduct([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'revision' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where the data product lives.

identifier
Required: Yes
Type: string

The ID of the data product.

revision
Type: string

The revision of the data product.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'firstRevisionCreatedAt' => <DateTime>,
    'firstRevisionCreatedBy' => '<string>',
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'items' => [
        [
            'glossaryTerms' => ['<string>', ...],
            'identifier' => '<string>',
            'itemType' => 'ASSET',
            'revision' => '<string>',
        ],
        // ...
    ],
    'name' => '<string>',
    'owningProjectId' => '<string>',
    'revision' => '<string>',
    'status' => 'CREATED|CREATING|CREATE_FAILED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the data product is created.

createdBy
Type: string

The user who created the data product.

description
Type: string

The description of the data product.

domainId
Required: Yes
Type: string

The ID of the domain where the data product lives.

firstRevisionCreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the first revision of the data product is created.

firstRevisionCreatedBy
Type: string

The user who created the first revision of the data product.

formsOutput
Type: Array of FormOutput structures

The metadata forms of the data product.

glossaryTerms
Type: Array of strings

The glossary terms of the data product.

id
Required: Yes
Type: string

The ID of the data product.

items
Type: Array of DataProductItem structures

The data assets of the data product.

name
Required: Yes
Type: string

The name of the data product.

owningProjectId
Required: Yes
Type: string

The ID of the owning project of the data product.

revision
Required: Yes
Type: string

The revision of the data product.

status
Required: Yes
Type: string

The status of the data product.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetDataSource

$result = $client->getDataSource([/* ... */]);
$promise = $client->getDataSourceAsync([/* ... */]);

Gets an Amazon DataZone data source.

Parameter Syntax

$result = $client->getDataSource([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the Amazon DataZone data source.

Result Syntax

[
    'assetFormsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'configuration' => [
        'glueRunConfiguration' => [
            'accountId' => '<string>',
            'autoImportDataQualityResult' => true || false,
            'catalogName' => '<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>',
                ],
                // ...
            ],
        ],
        'sageMakerRunConfiguration' => [
            'accountId' => '<string>',
            'region' => '<string>',
            'trackingAssets' => [
                '<SageMakerAssetType>' => ['<string>', ...],
                // ...
            ],
        ],
    ],
    'connectionId' => '<string>',
    'createdAt' => <DateTime>,
    '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' => <integer>,
    'lastRunAt' => <DateTime>,
    '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',
    ],
    'selfGrantStatus' => [
        'glueSelfGrantStatus' => [
            'selfGrantStatusDetails' => [
                [
                    'databaseName' => '<string>',
                    'failureCause' => '<string>',
                    'schemaName' => '<string>',
                    'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED',
                ],
                // ...
            ],
        ],
        'redshiftSelfGrantStatus' => [
            'selfGrantStatusDetails' => [
                [
                    'databaseName' => '<string>',
                    'failureCause' => '<string>',
                    'schemaName' => '<string>',
                    'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED',
                ],
                // ...
            ],
        ],
    ],
    'status' => 'CREATING|FAILED_CREATION|READY|UPDATING|FAILED_UPDATE|RUNNING|DELETING|FAILED_DELETION',
    'type' => '<string>',
    'updatedAt' => <DateTime>,
]

Result Details

Members
assetFormsOutput
Type: Array of FormOutput structures

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

configuration

The configuration of the data source.

connectionId
Type: string

The ID of the connection.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the data source was created.

description
Type: string

The description of the data source.

domainId
Required: Yes
Type: string

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

enableSetting
Type: string

Specifies whether this data source is enabled or not.

environmentId
Type: string

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

errorMessage
Type: DataSourceErrorMessage structure

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

id
Required: Yes
Type: string

The ID of the data source.

lastRunAssetCount
Type: int

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

lastRunAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of the last run of the data source.

lastRunErrorMessage
Type: DataSourceErrorMessage structure

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

lastRunStatus
Type: string

The status of the last run of the data source.

name
Required: Yes
Type: string

The name of the data source.

projectId
Required: Yes
Type: string

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

publishOnImport
Type: boolean

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

recommendation
Type: RecommendationConfiguration structure

The recommendation configuration of the data source.

schedule
Type: ScheduleConfiguration structure

The schedule of the data source runs.

selfGrantStatus
Type: SelfGrantStatusOutput structure

Specifies the status of the self-granting functionality.

status
Type: string

The status of the data source.

type
Type: string

The type of the data source.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the data source was updated.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetDataSourceRun

$result = $client->getDataSourceRun([/* ... */]);
$promise = $client->getDataSourceRunAsync([/* ... */]);

Gets an Amazon DataZone data source run.

Parameter Syntax

$result = $client->getDataSourceRun([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain in which this data source run was performed.

identifier
Required: Yes
Type: string

The ID of the data source run.

Result Syntax

[
    'createdAt' => <DateTime>,
    '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>',
    'lineageSummary' => [
        'importStatus' => 'IN_PROGRESS|SUCCESS|FAILED|PARTIALLY_SUCCEEDED',
    ],
    'projectId' => '<string>',
    'runStatisticsForAssets' => [
        'added' => <integer>,
        'failed' => <integer>,
        'skipped' => <integer>,
        'unchanged' => <integer>,
        'updated' => <integer>,
    ],
    'startedAt' => <DateTime>,
    'status' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS',
    'stoppedAt' => <DateTime>,
    'type' => 'PRIORITIZED|SCHEDULED',
    'updatedAt' => <DateTime>,
]

Result Details

Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the data source run was created.

dataSourceConfigurationSnapshot
Type: string

The configuration snapshot of the data source run.

dataSourceId
Required: Yes
Type: string

The ID of the data source for this data source run.

domainId
Required: Yes
Type: string

The ID of the domain in which this data source run was performed.

errorMessage
Type: DataSourceErrorMessage structure

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

id
Required: Yes
Type: string

The ID of the data source run.

lineageSummary
Type: DataSourceRunLineageSummary structure

The summary of the data lineage.

projectId
Required: Yes
Type: string

The ID of the project in which this data source run occured.

runStatisticsForAssets
Type: RunStatisticsForAssets structure

The asset statistics from this data source run.

startedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this data source run started.

status
Required: Yes
Type: string

The status of this data source run.

stoppedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this data source run stopped.

type
Required: Yes
Type: string

The type of this data source run.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this data source run was updated.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetDomain

$result = $client->getDomain([/* ... */]);
$promise = $client->getDomainAsync([/* ... */]);

Gets an Amazon DataZone domain.

Parameter Syntax

$result = $client->getDomain([
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
identifier
Required: Yes
Type: string

The identifier of the specified Amazon DataZone domain.

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'description' => '<string>',
    'domainExecutionRole' => '<string>',
    'domainVersion' => 'V1|V2',
    'id' => '<string>',
    'kmsKeyIdentifier' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'portalUrl' => '<string>',
    'rootDomainUnitId' => '<string>',
    'serviceRole' => '<string>',
    'singleSignOn' => [
        'type' => 'IAM_IDC|DISABLED',
        'userAssignment' => 'AUTOMATIC|MANUAL',
    ],
    'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED',
    'tags' => ['<string>', ...],
]

Result Details

Members
arn
Type: string

The ARN of the specified Amazon DataZone domain.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the Amazon DataZone domain was created.

description
Type: string

The description of the Amazon DataZone domain.

domainExecutionRole
Required: Yes
Type: string

The domain execution role with which the Amazon DataZone domain is created.

domainVersion
Type: string

The version of the domain.

id
Required: Yes
Type: string

The identifier of the specified Amazon DataZone domain.

kmsKeyIdentifier
Type: 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
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the Amazon DataZone domain was last updated.

name
Type: string

The name of the Amazon DataZone domain.

portalUrl
Type: string

The URL of the data portal for this Amazon DataZone domain.

rootDomainUnitId
Type: string

The ID of the root domain in Amazon Datazone.

serviceRole
Type: string

The service role of the domain.

singleSignOn
Type: SingleSignOn structure

The single sing-on option of the specified Amazon DataZone domain.

status
Required: Yes
Type: string

The status of the specified Amazon DataZone domain.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags specified for the Amazon DataZone domain.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetDomainUnit

$result = $client->getDomainUnit([/* ... */]);
$promise = $client->getDomainUnitAsync([/* ... */]);

Gets the details of the specified domain unit.

Parameter Syntax

$result = $client->getDomainUnit([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to get a domain unit.

identifier
Required: Yes
Type: string

The identifier of the domain unit that you want to get.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'lastUpdatedBy' => '<string>',
    'name' => '<string>',
    'owners' => [
        [
            'group' => [
                'groupId' => '<string>',
            ],
            'user' => [
                'userId' => '<string>',
            ],
        ],
        // ...
    ],
    'parentDomainUnitId' => '<string>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time stamp at which the domain unit was created.

createdBy
Type: string

The user who created the domain unit.

description
Type: string

The description of the domain unit.

domainId
Required: Yes
Type: string

The ID of the domain in which the domain unit lives.

id
Required: Yes
Type: string

The ID of the domain unit.

lastUpdatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the domain unit was last updated.

lastUpdatedBy
Type: string

The user who last updated the domain unit.

name
Required: Yes
Type: string

The name of the domain unit.

owners
Required: Yes
Type: Array of DomainUnitOwnerProperties structures

The owners of the domain unit.

parentDomainUnitId
Type: string

The ID of the parent domain unit.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetEnvironment

$result = $client->getEnvironment([/* ... */]);
$promise = $client->getEnvironmentAsync([/* ... */]);

Gets an Amazon DataZone environment.

Parameter Syntax

$result = $client->getEnvironment([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the Amazon DataZone environment.

Result Syntax

[
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'deploymentProperties' => [
        'endTimeoutMinutes' => <integer>,
        'startTimeoutMinutes' => <integer>,
    ],
    '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>,
    'userParameters' => [
        [
            'defaultValue' => '<string>',
            'description' => '<string>',
            'fieldType' => '<string>',
            'isEditable' => true || false,
            'isOptional' => true || false,
            'keyName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

The Amazon Web Services region where the environment exists.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the environment was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the environment.

deploymentProperties
Type: DeploymentProperties structure

The deployment properties of the environment.

description
Type: string

The description of the environment.

domainId
Required: Yes
Type: string

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

environmentActions
Type: Array of ConfigurableEnvironmentAction structures

The actions of the environment.

environmentBlueprintId
Type: string

The blueprint with which the environment is created.

environmentProfileId
Type: string

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

glossaryTerms
Type: Array of strings

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

id
Type: string

The ID of the environment.

lastDeployment
Type: Deployment structure

The details of the last deployment of the environment.

name
Required: Yes
Type: string

The name of the environment.

projectId
Required: Yes
Type: string

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

provider
Required: Yes
Type: string

The provider of this Amazon DataZone environment.

provisionedResources
Type: Array of Resource structures

The provisioned resources of this Amazon DataZone environment.

provisioningProperties
Type: ProvisioningProperties structure

The provisioning properties of this Amazon DataZone environment.

status
Type: string

The status of this Amazon DataZone environment.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this environment was updated.

userParameters
Type: Array of CustomParameter structures

The user parameters of this Amazon DataZone environment.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetEnvironmentAction

$result = $client->getEnvironmentAction([/* ... */]);
$promise = $client->getEnvironmentActionAsync([/* ... */]);

Gets the specified environment action.

Parameter Syntax

$result = $client->getEnvironmentAction([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which the GetEnvironmentAction API is invoked.

environmentIdentifier
Required: Yes
Type: string

The environment ID of the environment action.

identifier
Required: Yes
Type: string

The ID of the environment action

Result Syntax

[
    'description' => '<string>',
    'domainId' => '<string>',
    'environmentId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'parameters' => [
        'awsConsoleLink' => [
            'uri' => '<string>',
        ],
    ],
]

Result Details

Members
description
Type: string

The description of the environment action.

domainId
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which the environment action lives.

environmentId
Required: Yes
Type: string

The environment ID of the environment action.

id
Required: Yes
Type: string

The ID of the environment action.

name
Required: Yes
Type: string

The name of the environment action.

parameters
Required: Yes
Type: ActionParameters structure

The parameters of the environment action.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetEnvironmentBlueprint

$result = $client->getEnvironmentBlueprint([/* ... */]);
$promise = $client->getEnvironmentBlueprintAsync([/* ... */]);

Gets an Amazon DataZone blueprint.

Parameter Syntax

$result = $client->getEnvironmentBlueprint([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The identifier of the domain in which this blueprint exists.

identifier
Required: Yes
Type: string

The ID of this Amazon DataZone blueprint.

Result Syntax

[
    'createdAt' => <DateTime>,
    'deploymentProperties' => [
        'endTimeoutMinutes' => <integer>,
        'startTimeoutMinutes' => <integer>,
    ],
    'description' => '<string>',
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'name' => '<string>',
    'provider' => '<string>',
    'provisioningProperties' => [
        'cloudFormation' => [
            'templateUrl' => '<string>',
        ],
    ],
    'updatedAt' => <DateTime>,
    'userParameters' => [
        [
            'defaultValue' => '<string>',
            'description' => '<string>',
            'fieldType' => '<string>',
            'isEditable' => true || false,
            'isOptional' => true || false,
            'keyName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

A timestamp of when this blueprint was created.

deploymentProperties
Type: DeploymentProperties structure

The deployment properties of this Amazon DataZone blueprint.

description
Type: string

The description of this Amazon DataZone blueprint.

glossaryTerms
Type: Array of strings

The glossary terms attached to this Amazon DataZone blueprint.

id
Required: Yes
Type: string

The ID of this Amazon DataZone blueprint.

name
Required: Yes
Type: string

The name of this Amazon DataZone blueprint.

provider
Required: Yes
Type: string

The provider of this Amazon DataZone blueprint.

provisioningProperties
Required: Yes
Type: ProvisioningProperties structure

The provisioning properties of this Amazon DataZone blueprint.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this blueprint was updated.

userParameters
Type: Array of CustomParameter structures

The user parameters of this blueprint.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetEnvironmentBlueprintConfiguration

$result = $client->getEnvironmentBlueprintConfiguration([/* ... */]);
$promise = $client->getEnvironmentBlueprintConfigurationAsync([/* ... */]);

Gets the blueprint configuration in Amazon DataZone.

Parameter Syntax

$result = $client->getEnvironmentBlueprintConfiguration([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentBlueprintIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentBlueprintIdentifier
Required: Yes
Type: string

He ID of the blueprint.

Result Syntax

[
    'createdAt' => <DateTime>,
    'domainId' => '<string>',
    'enabledRegions' => ['<string>', ...],
    'environmentBlueprintId' => '<string>',
    'environmentRolePermissionBoundary' => '<string>',
    'manageAccessRoleArn' => '<string>',
    'provisioningConfigurations' => [
        [
            'lakeFormationConfiguration' => [
                'locationRegistrationExcludeS3Locations' => ['<string>', ...],
                'locationRegistrationRole' => '<string>',
            ],
        ],
        // ...
    ],
    'provisioningRoleArn' => '<string>',
    'regionalParameters' => [
        '<RegionName>' => ['<string>', ...],
        // ...
    ],
    'updatedAt' => <DateTime>,
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this blueprint was created.

domainId
Required: Yes
Type: string

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

enabledRegions
Type: Array of strings

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

environmentBlueprintId
Required: Yes
Type: string

The ID of the blueprint.

environmentRolePermissionBoundary
Type: string

The environment role permissions boundary.

manageAccessRoleArn
Type: string

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

provisioningConfigurations
Type: Array of ProvisioningConfiguration structures

The provisioning configuration of a blueprint.

provisioningRoleArn
Type: string

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

regionalParameters
Type: Associative array of custom strings keys (RegionName) to stringss

The regional parameters of the blueprint.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this blueprint was upated.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetEnvironmentCredentials

$result = $client->getEnvironmentCredentials([/* ... */]);
$promise = $client->getEnvironmentCredentialsAsync([/* ... */]);

Gets the credentials of an environment in Amazon DataZone.

Parameter Syntax

$result = $client->getEnvironmentCredentials([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which this environment and its credentials exist.

environmentIdentifier
Required: Yes
Type: string

The ID of the environment whose credentials this operation gets.

Result Syntax

[
    'accessKeyId' => '<string>',
    'expiration' => <DateTime>,
    'secretAccessKey' => '<string>',
    'sessionToken' => '<string>',
]

Result Details

Members
accessKeyId
Type: string

The access key ID of the environment.

expiration
Type: timestamp (string|DateTime or anything parsable by strtotime)

The expiration timestamp of the environment credentials.

secretAccessKey
Type: string

The secret access key of the environment credentials.

sessionToken
Type: string

The session token of the environment credentials.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetEnvironmentProfile

$result = $client->getEnvironmentProfile([/* ... */]);
$promise = $client->getEnvironmentProfileAsync([/* ... */]);

Gets an evinronment profile in Amazon DataZone.

Parameter Syntax

$result = $client->getEnvironmentProfile([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the environment profile.

Result Syntax

[
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'environmentBlueprintId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'projectId' => '<string>',
    'updatedAt' => <DateTime>,
    'userParameters' => [
        [
            'defaultValue' => '<string>',
            'description' => '<string>',
            'fieldType' => '<string>',
            'isEditable' => true || false,
            'isOptional' => true || false,
            'keyName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

The Amazon Web Services region where this environment profile exists.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this environment profile was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created this environment profile.

description
Type: string

The description of the environment profile.

domainId
Required: Yes
Type: string

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

environmentBlueprintId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The ID of the environment profile.

name
Required: Yes
Type: string

The name of the environment profile.

projectId
Type: string

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

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this environment profile was upated.

userParameters
Type: Array of CustomParameter structures

The user parameters of the environment profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetFormType

$result = $client->getFormType([/* ... */]);
$promise = $client->getFormTypeAsync([/* ... */]);

Gets a metadata form type in Amazon DataZone.

Parameter Syntax

$result = $client->getFormType([
    'domainIdentifier' => '<string>', // REQUIRED
    'formTypeIdentifier' => '<string>', // REQUIRED
    'revision' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

formTypeIdentifier
Required: Yes
Type: string

The ID of the metadata form type.

revision
Type: string

The revision of this metadata form type.

Result Syntax

[
    'createdAt' => <DateTime>,
    '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',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this metadata form type was created.

createdBy
Type: string

The Amazon DataZone user who created this metadata form type.

description
Type: string

The description of the metadata form type.

domainId
Required: Yes
Type: string

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

imports
Type: Array of Import structures

The imports of the metadata form type.

model
Required: Yes
Type: Model structure

The model of the metadata form type.

name
Required: Yes
Type: string

The name of the metadata form type.

originDomainId
Type: string

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

originProjectId
Type: string

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

owningProjectId
Type: string

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

revision
Required: Yes
Type: string

The revision of the metadata form type.

status
Type: string

The status of the metadata form type.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetGlossary

$result = $client->getGlossary([/* ... */]);
$promise = $client->getGlossaryAsync([/* ... */]);

Gets a business glossary in Amazon DataZone.

Parameter Syntax

$result = $client->getGlossary([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the business glossary.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'owningProjectId' => '<string>',
    'status' => 'DISABLED|ENABLED',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when this business glossary was created.

createdBy
Type: string

The Amazon DataZone user who created this business glossary.

description
Type: string

The description of the business glossary.

domainId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The ID of the business glossary.

name
Required: Yes
Type: string

The name of the business glossary.

owningProjectId
Required: Yes
Type: string

The ID of the project that owns this business glossary.

status
Required: Yes
Type: string

The status of the business glossary.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the business glossary was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the business glossary.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetGlossaryTerm

$result = $client->getGlossaryTerm([/* ... */]);
$promise = $client->getGlossaryTermAsync([/* ... */]);

Gets a business glossary term in Amazon DataZone.

Parameter Syntax

$result = $client->getGlossaryTerm([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the business glossary term.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'domainId' => '<string>',
    'glossaryId' => '<string>',
    'id' => '<string>',
    'longDescription' => '<string>',
    'name' => '<string>',
    'shortDescription' => '<string>',
    'status' => 'ENABLED|DISABLED',
    'termRelations' => [
        'classifies' => ['<string>', ...],
        'isA' => ['<string>', ...],
    ],
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the business glossary term was created.

createdBy
Type: string

The Amazon DataZone user who created the business glossary.

domainId
Required: Yes
Type: string

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

glossaryId
Required: Yes
Type: string

The ID of the business glossary to which this term belongs.

id
Required: Yes
Type: string

The ID of the business glossary term.

longDescription
Type: string

The long description of the business glossary term.

name
Required: Yes
Type: string

The name of the business glossary term.

shortDescription
Type: string

The short decription of the business glossary term.

status
Required: Yes
Type: string

The status of the business glossary term.

termRelations
Type: TermRelations structure

The relations of the business glossary term.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the business glossary term was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the business glossary term.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetGroupProfile

$result = $client->getGroupProfile([/* ... */]);
$promise = $client->getGroupProfileAsync([/* ... */]);

Gets a group profile in Amazon DataZone.

Parameter Syntax

$result = $client->getGroupProfile([
    'domainIdentifier' => '<string>', // REQUIRED
    'groupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

groupIdentifier
Required: Yes
Type: string

The identifier of the group profile.

Result Syntax

[
    'domainId' => '<string>',
    'groupName' => '<string>',
    'id' => '<string>',
    'status' => 'ASSIGNED|NOT_ASSIGNED',
]

Result Details

Members
domainId
Type: string

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

groupName
Type: string

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

id
Type: string

The identifier of the group profile.

status
Type: string

The identifier of the group profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetIamPortalLoginUrl

$result = $client->getIamPortalLoginUrl([/* ... */]);
$promise = $client->getIamPortalLoginUrlAsync([/* ... */]);

Gets the data portal URL for the specified Amazon DataZone domain.

Parameter Syntax

$result = $client->getIamPortalLoginUrl([
    'domainIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

Result Syntax

[
    'authCodeUrl' => '<string>',
    'userProfileId' => '<string>',
]

Result Details

Members
authCodeUrl
Type: string

The data portal URL of the specified Amazon DataZone domain.

userProfileId
Required: Yes
Type: string

The ID of the user profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetJobRun

$result = $client->getJobRun([/* ... */]);
$promise = $client->getJobRunAsync([/* ... */]);

The details of the job run.

Parameter Syntax

$result = $client->getJobRun([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain.

identifier
Required: Yes
Type: string

The ID of the job run.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'details' => [
        'lineageRunDetails' => [
            'sqlQueryRunDetails' => [
                'errorMessages' => ['<string>', ...],
                'numQueriesFailed' => <integer>,
                'queryEndTime' => <DateTime>,
                'queryStartTime' => <DateTime>,
                'totalQueriesProcessed' => <integer>,
            ],
        ],
    ],
    'domainId' => '<string>',
    'endTime' => <DateTime>,
    'error' => [
        'message' => '<string>',
    ],
    'id' => '<string>',
    'jobId' => '<string>',
    'jobType' => 'LINEAGE',
    'runMode' => 'SCHEDULED|ON_DEMAND',
    'startTime' => <DateTime>,
    'status' => 'SCHEDULED|IN_PROGRESS|SUCCESS|PARTIALLY_SUCCEEDED|FAILED|ABORTED|TIMED_OUT|CANCELED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the job run was created.

createdBy
Type: string

The user who created the job run.

details
Type: JobRunDetails structure

The details of the job run.

domainId
Type: string

The ID of the domain.

endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the job run ended.

error
Type: JobRunError structure

The error generated if the action is not completed successfully.

id
Type: string

The ID of the job run.

jobId
Type: string

The ID of the job run.

jobType
Type: string

The type of the job run.

runMode
Type: string

The mode of the job run.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the job run started.

status
Type: string

The status of the job run.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetLineageEvent

$result = $client->getLineageEvent([/* ... */]);
$promise = $client->getLineageEventAsync([/* ... */]);

Describes the lineage event.

Parameter Syntax

$result = $client->getLineageEvent([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain.

identifier
Required: Yes
Type: string

The ID of the lineage event.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'domainId' => '<string>',
    'event' => <string || resource || Psr\Http\Message\StreamInterface>,
    'eventTime' => <DateTime>,
    'id' => '<string>',
    'processingStatus' => 'REQUESTED|PROCESSING|SUCCESS|FAILED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the lineage event was created.

createdBy
Type: string

The user who created the lineage event.

domainId
Type: string

The ID of the domain.

event
Type: blob (string|resource|Psr\Http\Message\StreamInterface)

The lineage event details.

eventTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time of the lineage event.

id
Type: string

The ID of the lineage event.

processingStatus
Type: string

The progressing status of the lineage event.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetLineageNode

$result = $client->getLineageNode([/* ... */]);
$promise = $client->getLineageNodeAsync([/* ... */]);

Gets the data lineage node.

Parameter Syntax

$result = $client->getLineageNode([
    'domainIdentifier' => '<string>', // REQUIRED
    'eventTimestamp' => <integer || string || DateTime>,
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain in which you want to get the data lineage node.

eventTimestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The event time stamp for which you want to get the data lineage node.

identifier
Required: Yes
Type: string

The ID of the data lineage node that you want to get.

Both, a lineage node identifier generated by Amazon DataZone and a sourceIdentifier of the lineage node are supported. If sourceIdentifier is greater than 1800 characters, you can use lineage node identifier generated by Amazon DataZone to get the node details.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'downstreamNodes' => [
        [
            'eventTimestamp' => <DateTime>,
            'id' => '<string>',
        ],
        // ...
    ],
    'eventTimestamp' => <DateTime>,
    'formsOutput' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'id' => '<string>',
    'name' => '<string>',
    'sourceIdentifier' => '<string>',
    'typeName' => '<string>',
    'typeRevision' => '<string>',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
    'upstreamNodes' => [
        [
            'eventTimestamp' => <DateTime>,
            'id' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the data lineage node was created.

createdBy
Type: string

The user who created the data lineage node.

description
Type: string

The description of the data lineage node.

domainId
Required: Yes
Type: string

The ID of the domain where you're getting the data lineage node.

downstreamNodes
Type: Array of LineageNodeReference structures

The downsteam nodes of the specified data lineage node.

eventTimestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of the event described in the data lineage node.

formsOutput
Type: Array of FormOutput structures

The metadata of the specified data lineage node.

id
Required: Yes
Type: string

The ID of the data lineage node.

name
Type: string

The name of the data lineage node.

sourceIdentifier
Type: string

The source identifier of the data lineage node.

typeName
Required: Yes
Type: string

The name of the type of the specified data lineage node.

typeRevision
Type: string

The revision type of the specified data lineage node.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the data lineage node was updated.

updatedBy
Type: string

The user who updated the data lineage node.

upstreamNodes
Type: Array of LineageNodeReference structures

The upstream nodes of the specified data lineage node.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetListing

$result = $client->getListing([/* ... */]);
$promise = $client->getListingAsync([/* ... */]);

Gets a listing (a record of an asset at a given time). If you specify a listing version, only details that are specific to that version are returned.

Parameter Syntax

$result = $client->getListing([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'listingRevision' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain.

identifier
Required: Yes
Type: string

The ID of the listing.

listingRevision
Type: string

The revision of the listing.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'item' => [
        'assetListing' => [
            'assetId' => '<string>',
            'assetRevision' => '<string>',
            'assetType' => '<string>',
            'createdAt' => <DateTime>,
            'forms' => '<string>',
            'glossaryTerms' => [
                [
                    'name' => '<string>',
                    'shortDescription' => '<string>',
                ],
                // ...
            ],
            'latestTimeSeriesDataPointForms' => [
                [
                    'contentSummary' => '<string>',
                    'formName' => '<string>',
                    'id' => '<string>',
                    'timestamp' => <DateTime>,
                    'typeIdentifier' => '<string>',
                    'typeRevision' => '<string>',
                ],
                // ...
            ],
            'owningProjectId' => '<string>',
        ],
        'dataProductListing' => [
            'createdAt' => <DateTime>,
            'dataProductId' => '<string>',
            'dataProductRevision' => '<string>',
            'forms' => '<string>',
            'glossaryTerms' => [
                [
                    'name' => '<string>',
                    'shortDescription' => '<string>',
                ],
                // ...
            ],
            'items' => [
                [
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                    'listingId' => '<string>',
                    'listingRevision' => '<string>',
                ],
                // ...
            ],
            'owningProjectId' => '<string>',
        ],
    ],
    'listingRevision' => '<string>',
    'name' => '<string>',
    'status' => 'CREATING|ACTIVE|INACTIVE',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the listing was created.

createdBy
Type: string

The Amazon DataZone user who created the listing.

description
Type: string

The description of the listing.

domainId
Required: Yes
Type: string

The ID of the Amazon DataZone domain.

id
Required: Yes
Type: string

The ID of the listing.

item
Type: ListingItem structure

The details of a listing.

listingRevision
Required: Yes
Type: string

The revision of a listing.

name
Type: string

The name of the listing.

status
Type: string

The status of the listing.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the listing was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the listing.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetMetadataGenerationRun

$result = $client->getMetadataGenerationRun([/* ... */]);
$promise = $client->getMetadataGenerationRunAsync([/* ... */]);

Gets a metadata generation run in Amazon DataZone.

Parameter Syntax

$result = $client->getMetadataGenerationRun([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain the metadata generation run of which you want to get.

identifier
Required: Yes
Type: string

The identifier of the metadata generation run.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'owningProjectId' => '<string>',
    'status' => 'SUBMITTED|IN_PROGRESS|CANCELED|SUCCEEDED|FAILED',
    'target' => [
        'identifier' => '<string>',
        'revision' => '<string>',
        'type' => 'ASSET',
    ],
    'type' => 'BUSINESS_DESCRIPTIONS',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the metadata generation run was start.

createdBy
Type: string

The Amazon DataZone user who started the metadata generation run.

domainId
Required: Yes
Type: string

The ID of the Amazon DataZone domain the metadata generation run of which you want to get.

id
Required: Yes
Type: string

The ID of the metadata generation run.

owningProjectId
Required: Yes
Type: string

The ID of the project that owns the assets for which you're running metadata generation.

status
Type: string

The status of the metadata generation run.

target
Type: MetadataGenerationRunTarget structure

The asset for which you're generating metadata.

type
Type: string

The type of metadata generation run.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetProject

$result = $client->getProject([/* ... */]);
$promise = $client->getProjectAsync([/* ... */]);

Gets a project in Amazon DataZone.

Parameter Syntax

$result = $client->getProject([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the project.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'environmentDeploymentDetails' => [
        'environmentFailureReasons' => [
            '<String>' => [
                [
                    'code' => '<string>',
                    'message' => '<string>',
                ],
                // ...
            ],
            // ...
        ],
        'overallDeploymentStatus' => 'PENDING_DEPLOYMENT|IN_PROGRESS|SUCCESSFUL|FAILED_VALIDATION|FAILED_DEPLOYMENT',
    ],
    'failureReasons' => [
        [
            'code' => '<string>',
            'message' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'projectProfileId' => '<string>',
    'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED',
    'userParameters' => [
        [
            'environmentConfigurationName' => '<string>',
            'environmentParameters' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
        ],
        // ...
    ],
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the project was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the project.

description
Type: string

The description of the project.

domainId
Required: Yes
Type: string

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

domainUnitId
Type: string

The ID of the domain unit.

environmentDeploymentDetails

The environment deployment status of a project.

failureReasons
Type: Array of ProjectDeletionError structures

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

glossaryTerms
Type: Array of strings

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

id
Required: Yes
Type: string

>The ID of the project.

lastUpdatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the project was last updated.

name
Required: Yes
Type: string

The name of the project.

projectProfileId
Type: string

The ID of the project profile of a project.

projectStatus
Type: string

The status of the project.

userParameters
Type: Array of EnvironmentConfigurationUserParameter structures

The user parameters of a project.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetProjectProfile

$result = $client->getProjectProfile([/* ... */]);
$promise = $client->getProjectProfileAsync([/* ... */]);

The details of the project profile.

Parameter Syntax

$result = $client->getProjectProfile([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain.

identifier
Required: Yes
Type: string

The ID of the project profile.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'environmentConfigurations' => [
        [
            'awsAccount' => [
                'awsAccountId' => '<string>',
                'awsAccountIdPath' => '<string>',
            ],
            'awsRegion' => [
                'regionName' => '<string>',
                'regionNamePath' => '<string>',
            ],
            'configurationParameters' => [
                'parameterOverrides' => [
                    [
                        'isEditable' => true || false,
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'resolvedParameters' => [
                    [
                        'isEditable' => true || false,
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'ssmPath' => '<string>',
            ],
            'deploymentMode' => 'ON_CREATE|ON_DEMAND',
            'deploymentOrder' => <integer>,
            'description' => '<string>',
            'environmentBlueprintId' => '<string>',
            'id' => '<string>',
            'name' => '<string>',
        ],
        // ...
    ],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'status' => 'ENABLED|DISABLED',
]

Result Details

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the project profile was created.

createdBy
Required: Yes
Type: string

The user who created the project profile.

description
Type: string

The description of the project profile.

domainId
Required: Yes
Type: string

The ID of the domain of the project profile.

domainUnitId
Type: string

The ID of the domain unit of the project profile.

environmentConfigurations
Type: Array of EnvironmentConfiguration structures

The environment configurations of the project profile.

id
Required: Yes
Type: string

The ID of the project profile.

lastUpdatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when project profile was last updated.

name
Required: Yes
Type: string

The name of the project profile.

status
Type: string

The status of the project profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetRule

$result = $client->getRule([/* ... */]);
$promise = $client->getRuleAsync([/* ... */]);

Gets the details of a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

Parameter Syntax

$result = $client->getRule([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'revision' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where the GetRule action is to be invoked.

identifier
Required: Yes
Type: string

The ID of the rule.

revision
Type: string

The revision of the rule.

Result Syntax

[
    'action' => 'CREATE_SUBSCRIPTION_REQUEST',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'detail' => [
        'metadataFormEnforcementDetail' => [
            'requiredMetadataForms' => [
                [
                    'typeIdentifier' => '<string>',
                    'typeRevision' => '<string>',
                ],
                // ...
            ],
        ],
    ],
    'identifier' => '<string>',
    'lastUpdatedBy' => '<string>',
    'name' => '<string>',
    'revision' => '<string>',
    'ruleType' => 'METADATA_FORM_ENFORCEMENT',
    'scope' => [
        'assetType' => [
            'selectionMode' => 'ALL|SPECIFIC',
            'specificAssetTypes' => ['<string>', ...],
        ],
        'dataProduct' => true || false,
        'project' => [
            'selectionMode' => 'ALL|SPECIFIC',
            'specificProjects' => ['<string>', ...],
        ],
    ],
    'target' => [
        'domainUnitTarget' => [
            'domainUnitId' => '<string>',
            'includeChildDomainUnits' => true || false,
        ],
    ],
    'targetType' => 'DOMAIN_UNIT',
    'updatedAt' => <DateTime>,
]

Result Details

Members
action
Required: Yes
Type: string

The action of the rule.

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the rule was created.

createdBy
Required: Yes
Type: string

The user who created the rule.

description
Type: string

The description of the rule.

detail
Required: Yes
Type: RuleDetail structure

The detail of the rule.

identifier
Required: Yes
Type: string

The ID of the rule.

lastUpdatedBy
Required: Yes
Type: string

The timestamp at which the rule was last updated.

name
Required: Yes
Type: string

The name of the rule.

revision
Required: Yes
Type: string

The revision of the rule.

ruleType
Required: Yes
Type: string

The type of the rule.

scope
Required: Yes
Type: RuleScope structure

The scope of the rule.

target
Required: Yes
Type: RuleTarget structure

The target of the rule.

targetType
Type: string

The target type of the rule.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp at which the rule was last updated.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetSubscription

$result = $client->getSubscription([/* ... */]);
$promise = $client->getSubscriptionAsync([/* ... */]);

Gets a subscription in Amazon DataZone.

Parameter Syntax

$result = $client->getSubscription([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the subscription.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'domainId' => '<string>',
    'id' => '<string>',
    'retainPermissions' => true || false,
    'status' => 'APPROVED|REVOKED|CANCELLED',
    'subscribedListing' => [
        'description' => '<string>',
        'id' => '<string>',
        'item' => [
            'assetListing' => [
                'assetScope' => [
                    'assetId' => '<string>',
                    'errorMessage' => '<string>',
                    'filterIds' => ['<string>', ...],
                    'status' => '<string>',
                ],
                'entityId' => '<string>',
                'entityRevision' => '<string>',
                'entityType' => '<string>',
                'forms' => '<string>',
                'glossaryTerms' => [
                    [
                        'name' => '<string>',
                        'shortDescription' => '<string>',
                    ],
                    // ...
                ],
            ],
            'productListing' => [
                'assetListings' => [
                    [
                        'entityId' => '<string>',
                        'entityRevision' => '<string>',
                        'entityType' => '<string>',
                    ],
                    // ...
                ],
                'description' => '<string>',
                'entityId' => '<string>',
                'entityRevision' => '<string>',
                'glossaryTerms' => [
                    [
                        'name' => '<string>',
                        'shortDescription' => '<string>',
                    ],
                    // ...
                ],
                'name' => '<string>',
            ],
        ],
        'name' => '<string>',
        'ownerProjectId' => '<string>',
        'ownerProjectName' => '<string>',
        'revision' => '<string>',
    ],
    'subscribedPrincipal' => [
        'project' => [
            'id' => '<string>',
            'name' => '<string>',
        ],
    ],
    'subscriptionRequestId' => '<string>',
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription.

domainId
Required: Yes
Type: string

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

id
Required: Yes
Type: string

The ID of the subscription.

retainPermissions
Type: boolean

The retain permissions of the subscription.

status
Required: Yes
Type: string

The status of the subscription.

subscribedListing
Required: Yes
Type: SubscribedListing structure

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

subscribedPrincipal
Required: Yes
Type: SubscribedPrincipal structure

The principal that owns the subscription.

subscriptionRequestId
Type: string

The ID of the subscription request.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetSubscriptionGrant

$result = $client->getSubscriptionGrant([/* ... */]);
$promise = $client->getSubscriptionGrantAsync([/* ... */]);

Gets the subscription grant in Amazon DataZone.

Parameter Syntax

$result = $client->getSubscriptionGrant([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The ID of the subscription grant.

Result Syntax

[
    'assets' => [
        [
            'assetId' => '<string>',
            'assetRevision' => '<string>',
            'assetScope' => [
                'assetId' => '<string>',
                'errorMessage' => '<string>',
                'filterIds' => ['<string>', ...],
                'status' => '<string>',
            ],
            'failureCause' => [
                'message' => '<string>',
            ],
            'failureTimestamp' => <DateTime>,
            'grantedTimestamp' => <DateTime>,
            'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED',
            'targetName' => '<string>',
        ],
        // ...
    ],
    'createdAt' => <DateTime>,
    '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>,
    'updatedBy' => '<string>',
]

Result Details

Members
assets
Type: Array of SubscribedAsset structures

The assets for which the subscription grant is created.

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription grant is created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription grant.

domainId
Required: Yes
Type: string

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

grantedEntity
Required: Yes
Type: GrantedEntity structure

The entity to which the subscription is granted.

id
Required: Yes
Type: string

The ID of the subscription grant.

status
Required: Yes
Type: string

The status of the subscription grant.

subscriptionId
Type: string

The identifier of the subscription.

subscriptionTargetId
Required: Yes
Type: string

The subscription target ID associated with the subscription grant.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription grant was upated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription grant.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetSubscriptionRequestDetails

$result = $client->getSubscriptionRequestDetails([/* ... */]);
$promise = $client->getSubscriptionRequestDetailsAsync([/* ... */]);

Gets the details of the specified subscription request.

Parameter Syntax

$result = $client->getSubscriptionRequestDetails([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

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

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'decisionComment' => '<string>',
    'domainId' => '<string>',
    'existingSubscriptionId' => '<string>',
    'id' => '<string>',
    'metadataForms' => [
        [
            'content' => '<string>',
            'formName' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
        ],
        // ...
    ],
    'requestReason' => '<string>',
    'reviewerId' => '<string>',
    'status' => 'PENDING|ACCEPTED|REJECTED',
    'subscribedListings' => [
        [
            'description' => '<string>',
            'id' => '<string>',
            'item' => [
                'assetListing' => [
                    'assetScope' => [
                        'assetId' => '<string>',
                        'errorMessage' => '<string>',
                        'filterIds' => ['<string>', ...],
                        'status' => '<string>',
                    ],
                    'entityId' => '<string>',
                    'entityRevision' => '<string>',
                    'entityType' => '<string>',
                    'forms' => '<string>',
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                ],
                'productListing' => [
                    'assetListings' => [
                        [
                            'entityId' => '<string>',
                            'entityRevision' => '<string>',
                            'entityType' => '<string>',
                        ],
                        // ...
                    ],
                    'description' => '<string>',
                    'entityId' => '<string>',
                    'entityRevision' => '<string>',
                    'glossaryTerms' => [
                        [
                            'name' => '<string>',
                            'shortDescription' => '<string>',
                        ],
                        // ...
                    ],
                    'name' => '<string>',
                ],
            ],
            'name' => '<string>',
            'ownerProjectId' => '<string>',
            'ownerProjectName' => '<string>',
            'revision' => '<string>',
        ],
        // ...
    ],
    'subscribedPrincipals' => [
        [
            'project' => [
                'id' => '<string>',
                'name' => '<string>',
            ],
        ],
        // ...
    ],
    'updatedAt' => <DateTime>,
    'updatedBy' => '<string>',
]

Result Details

Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the specified subscription request was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription request.

decisionComment
Type: string

The decision comment of the subscription request.

domainId
Required: Yes
Type: string

The Amazon DataZone domain of the subscription request.

existingSubscriptionId
Type: string

The ID of the existing subscription.

id
Required: Yes
Type: string

The identifier of the subscription request.

metadataForms
Type: Array of FormOutput structures

The metadata forms included in the subscription request.

requestReason
Required: Yes
Type: string

The reason for the subscription request.

reviewerId
Type: string

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

status
Required: Yes
Type: string

The status of the subscription request.

subscribedListings
Required: Yes
Type: Array of SubscribedListing structures

The subscribed listings in the subscription request.

subscribedPrincipals
Required: Yes
Type: Array of SubscribedPrincipal structures

The subscribed principals in the subscription request.

updatedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription request was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription request.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetSubscriptionTarget

$result = $client->getSubscriptionTarget([/* ... */]);
$promise = $client->getSubscriptionTargetAsync([/* ... */]);

Gets the subscription target in Amazon DataZone.

Parameter Syntax

$result = $client->getSubscriptionTarget([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

The ID of the environment associated with the subscription target.

identifier
Required: Yes
Type: string

The ID of the subscription target.

Result Syntax

[
    'applicableAssetTypes' => ['<string>', ...],
    'authorizedPrincipals' => ['<string>', ...],
    'createdAt' => <DateTime>,
    '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>,
    'updatedBy' => '<string>',
]

Result Details

Members
applicableAssetTypes
Required: Yes
Type: Array of strings

The asset types associated with the subscription target.

authorizedPrincipals
Required: Yes
Type: Array of strings

The authorized principals of the subscription target.

createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription target was created.

createdBy
Required: Yes
Type: string

The Amazon DataZone user who created the subscription target.

domainId
Required: Yes
Type: string

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

environmentId
Required: Yes
Type: string

The ID of the environment associated with the subscription target.

id
Required: Yes
Type: string

The ID of the subscription target.

manageAccessRole
Type: string

The manage access role with which the subscription target was created.

name
Required: Yes
Type: string

The name of the subscription target.

projectId
Required: Yes
Type: string

The ID of the project associated with the subscription target.

provider
Required: Yes
Type: string

The provider of the subscription target.

subscriptionTargetConfig
Required: Yes
Type: Array of SubscriptionTargetForm structures

The configuration of teh subscription target.

type
Required: Yes
Type: string

The type of the subscription target.

updatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of when the subscription target was updated.

updatedBy
Type: string

The Amazon DataZone user who updated the subscription target.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetTimeSeriesDataPoint

$result = $client->getTimeSeriesDataPoint([/* ... */]);
$promise = $client->getTimeSeriesDataPointAsync([/* ... */]);

Gets the existing data point for the asset.

Parameter Syntax

$result = $client->getTimeSeriesDataPoint([
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityType' => 'ASSET|LISTING', // REQUIRED
    'formName' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain that houses the asset for which you want to get the data point.

entityIdentifier
Required: Yes
Type: string

The ID of the asset for which you want to get the data point.

entityType
Required: Yes
Type: string

The type of the asset for which you want to get the data point.

formName
Required: Yes
Type: string

The name of the time series form that houses the data point that you want to get.

identifier
Required: Yes
Type: string

The ID of the data point that you want to get.

Result Syntax

[
    'domainId' => '<string>',
    'entityId' => '<string>',
    'entityType' => 'ASSET|LISTING',
    'form' => [
        'content' => '<string>',
        'formName' => '<string>',
        'id' => '<string>',
        'timestamp' => <DateTime>,
        'typeIdentifier' => '<string>',
        'typeRevision' => '<string>',
    ],
    'formName' => '<string>',
]

Result Details

Members
domainId
Type: string

The ID of the Amazon DataZone domain that houses the asset data point that you want to get.

entityId
Type: string

The ID of the asset for which you want to get the data point.

entityType
Type: string

The type of the asset for which you want to get the data point.

form

The time series form that houses the data point that you want to get.

formName
Type: string

The name of the time series form that houses the data point that you want to get.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

GetUserProfile

$result = $client->getUserProfile([/* ... */]);
$promise = $client->getUserProfileAsync([/* ... */]);

Gets a user profile in Amazon DataZone.

Parameter Syntax

$result = $client->getUserProfile([
    'domainIdentifier' => '<string>', // REQUIRED
    'type' => 'IAM|SSO',
    'userIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

type
Type: string

The type of the user profile.

userIdentifier
Required: Yes
Type: string

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

Result 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',
]

Result Details

Members
details
Type: UserProfileDetails structure

The details of the user profile in Amazon DataZone.

domainId
Type: string

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

id
Type: string

The identifier of the user profile.

status
Type: string

The status of the user profile.

type
Type: string

The type of the user profile.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

ListAssetFilters

$result = $client->listAssetFilters([/* ... */]);
$promise = $client->listAssetFiltersAsync([/* ... */]);

Lists asset filters.

Parameter Syntax

$result = $client->listAssetFilters([
    'assetIdentifier' => '<string>', // REQUIRED
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'VALID|INVALID',
]);

Parameter Details

Members
assetIdentifier
Required: Yes
Type: string

The ID of the data asset.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to list asset filters.

maxResults
Type: int

The maximum number of asset filters to return in a single call to ListAssetFilters. When the number of asset filters 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 ListAssetFilters to list the next set of asset filters.

nextToken
Type: string

When the number of asset filters 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 asset filters, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListAssetFilters to list the next set of asset filters.

status
Type: string

The status of the asset filter.

Result Syntax

[
    'items' => [
        [
            'assetId' => '<string>',
            'createdAt' => <DateTime>,
            'description' => '<string>',
            'domainId' => '<string>',
            'effectiveColumnNames' => ['<string>', ...],
            'effectiveRowFilter' => '<string>',
            'errorMessage' => '<string>',
            'id' => '<string>',
            'name' => '<string>',
            'status' => 'VALID|INVALID',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of AssetFilterSummary structures

The results of the ListAssetFilters action.

nextToken
Type: string

When the number of asset filters 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 asset filters, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListAssetFilters to list the next set of asset filters.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

ListAssetRevisions

$result = $client->listAssetRevisions([/* ... */]);
$promise = $client->listAssetRevisionsAsync([/* ... */]);

Lists the revisions for the asset.

Parameter Syntax

$result = $client->listAssetRevisions([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The identifier of the domain.

identifier
Required: Yes
Type: string

The identifier of the asset.

maxResults
Type: int

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.

nextToken
Type: 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.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'domainId' => '<string>',
            'id' => '<string>',
            'revision' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Type: Array of AssetRevision structures

The results of the ListAssetRevisions action.

nextToken
Type: 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.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

ListConnections

$result = $client->listConnections([/* ... */]);
$promise = $client->listConnectionsAsync([/* ... */]);

Lists connections. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.

Parameter Syntax

$result = $client->listConnections([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>',
    'maxResults' => <integer>,
    'name' => '<string>',
    'nextToken' => '<string>',
    'projectIdentifier' => '<string>', // REQUIRED
    'sortBy' => 'NAME',
    'sortOrder' => 'ASCENDING|DESCENDING',
    'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to list connections.

environmentIdentifier
Type: string

The ID of the environment where you want to list connections.

maxResults
Type: int

The maximum number of connections to return in a single call to ListConnections. When the number of connections 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 ListConnections to list the next set of connections.

name
Type: string

The name of the connection.

nextToken
Type: string

When the number of connections 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 connections, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListConnections to list the next set of connections.

projectIdentifier
Required: Yes
Type: string

The ID of the project where you want to list connections.

sortBy
Type: string

Specifies how you want to sort the listed connections.

sortOrder
Type: string

Specifies the sort order for the listed connections.

type
Type: string

The type of connection.

Result Syntax

[
    'items' => [
        [
            'connectionId' => '<string>',
            'domainId' => '<string>',
            'domainUnitId' => '<string>',
            'environmentId' => '<string>',
            'name' => '<string>',
            'physicalEndpoints' => [
                [
                    'awsLocation' => [
                        'accessRole' => '<string>',
                        'awsAccountId' => '<string>',
                        'awsRegion' => '<string>',
                        'iamConnectionId' => '<string>',
                    ],
                    'glueConnection' => [
                        'athenaProperties' => ['<string>', ...],
                        'authenticationConfiguration' => [
                            'authenticationType' => 'BASIC|OAUTH2|CUSTOM',
                            'oAuth2Properties' => [
                                'authorizationCodeProperties' => [
                                    'authorizationCode' => '<string>',
                                    'redirectUri' => '<string>',
                                ],
                                'oAuth2ClientApplication' => [
                                    'aWSManagedClientApplicationReference' => '<string>',
                                    'userManagedClientApplicationClientId' => '<string>',
                                ],
                                'oAuth2Credentials' => [
                                    'accessToken' => '<string>',
                                    'jwtToken' => '<string>',
                                    'refreshToken' => '<string>',
                                    'userManagedClientApplicationClientSecret' => '<string>',
                                ],
                                'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER',
                                'tokenUrl' => '<string>',
                                'tokenUrlParametersMap' => ['<string>', ...],
                            ],
                            'secretArn' => '<string>',
                        ],
                        'compatibleComputeEnvironments' => ['<string>', ...],
                        'connectionProperties' => ['<string>', ...],
                        'connectionSchemaVersion' => <integer>,
                        'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
                        'creationTime' => <DateTime>,
                        'description' => '<string>',
                        'lastConnectionValidationTime' => <DateTime>,
                        'lastUpdatedBy' => '<string>',
                        'lastUpdatedTime' => <DateTime>,
                        'matchCriteria' => ['<string>', ...],
                        'name' => '<string>',
                        'physicalConnectionRequirements' => [
                            'availabilityZone' => '<string>',
                            'securityGroupIdList' => ['<string>', ...],
                            'subnetId' => '<string>',
                            'subnetIdList' => ['<string>', ...],
                        ],
                        'pythonProperties' => ['<string>', ...],
                        'sparkProperties' => ['<string>', ...],
                        'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
                        'statusReason' => '<string>',
                    ],
                    'glueConnectionName' => '<string>',
                    'host' => '<string>',
                    'port' => <integer>,
                    'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM',
                    'stage' => '<string>',
                ],
                // ...
            ],
            'projectId' => '<string>',
            'props' => [
                'athenaProperties' => [
                    'workgroupName' => '<string>',
                ],
                'glueProperties' => [
                    'errorMessage' => '<string>',
                    'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
                ],
                'hyperPodProperties' => [
                    'clusterArn' => '<string>',
                    'clusterName' => '<string>',
                    'orchestrator' => 'EKS|SLURM',
                ],
                'iamProperties' => [
                    'environmentId' => '<string>',
                    'glueLineageSyncEnabled' => true || false,
                ],
                'redshiftProperties' => [
                    'credentials' => [
                        'secretArn' => '<string>',
                        'usernamePassword' => [
                            'password' => '<string>',
                            'username' => '<string>',
                        ],
                    ],
                    'databaseName' => '<string>',
                    'isProvisionedSecret' => true || false,
                    'jdbcIamUrl' => '<string>',
                    'jdbcUrl' => '<string>',
                    'lineageSync' => [
                        'enabled' => true || false,
                        'lineageJobId' => '<string>',
                        'schedule' => [
                            'schedule' => '<string>',
                        ],
                    ],
                    'redshiftTempDir' => '<string>',
                    'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED',
                    'storage' => [
                        'clusterName' => '<string>',
                        'workgroupName' => '<string>',
                    ],
                ],
                'sparkEmrProperties' => [
                    'computeArn' => '<string>',
                    'credentials' => [
                        'password' => '<string>',
                        'username' => '<string>',
                    ],
                    'credentialsExpiration' => <DateTime>,
                    'governanceType' => 'AWS_MANAGED|USER_MANAGED',
                    'instanceProfileArn' => '<string>',
                    'javaVirtualEnv' => '<string>',
                    'livyEndpoint' => '<string>',
                    'logUri' => '<string>',
                    'pythonVirtualEnv' => '<string>',
                    'runtimeRole' => '<string>',
                    'trustedCertificatesS3Uri' => '<string>',
                ],
                'sparkGlueProperties' => [
                    'additionalArgs' => [
                        'connection' => '<string>',
                    ],
                    'glueConnectionName' => '<string>',
                    'glueVersion' => '<string>',
                    'idleTimeout' => <integer>,
                    'javaVirtualEnv' => '<string>',
                    'numberOfWorkers' => <integer>,
                    'pythonVirtualEnv' => '<string>',
                    'workerType' => '<string>',
                ],
            ],
            'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of ConnectionSummary structures

The results of the ListConnections action.

nextToken
Type: string

When the number of connections 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 connections, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListConnections to list the next set of connections.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

ListDataProductRevisions

$result = $client->listDataProductRevisions([/* ... */]);
$promise = $client->listDataProductRevisionsAsync([/* ... */]);

Lists data product revisions.

Parameter Syntax

$result = $client->listDataProductRevisions([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain of the data product revisions that you want to list.

identifier
Required: Yes
Type: string

The ID of the data product revision.

maxResults
Type: int

The maximum number of asset filters to return in a single call to ListDataProductRevisions. When the number of data product 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 ListDataProductRevisions to list the next set of data product revisions.

nextToken
Type: string

When the number of data product 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 data product revisions, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListDataProductRevisions to list the next set of data product revisions.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'domainId' => '<string>',
            'id' => '<string>',
            'revision' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of DataProductRevision structures

The results of the ListDataProductRevisions action.

nextToken
Type: string

When the number of data product 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 data product revisions, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListDataProductRevisions to list the next set of data product revisions.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.

ListDataSourceRunActivities

$result = $client->listDataSourceRunActivities([/* ... */]);
$promise = $client->listDataSourceRunActivitiesAsync([/* ... */]);

Lists data source run activities.

Parameter Syntax

$result = $client->listDataSourceRunActivities([
    'domainIdentifier' => '<string>', // REQUIRED
    'identifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'FAILED|PUBLISHING_FAILED|SUCCEEDED_CREATED|SUCCEEDED_UPDATED|SKIPPED_ALREADY_IMPORTED|SKIPPED_ARCHIVED|SKIPPED_NO_ACCESS|UNCHANGED',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

identifier
Required: Yes
Type: string

The identifier of the data source run.

maxResults
Type: int

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.

nextToken
Type: 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.

status
Type: string

The status of the data source run.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            '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',
            ],
            'lineageSummary' => [
                'errorMessage' => '<string>',
                'eventId' => '<string>',
                'eventStatus' => 'REQUESTED|PROCESSING|SUCCESS|FAILED',
            ],
            'projectId' => '<string>',
            'technicalDescription' => '<string>',
            'technicalName' => '<string>',
            'updatedAt' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of DataSourceRunActivity structures

The results of the ListDataSourceRunActivities action.

nextToken
Type: 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.

Errors

InternalServerException:

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException:

The specified resource cannot be found.

AccessDeniedException:

You do not have sufficient access to perform this action.

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

The request has exceeded the specified service quota.

ConflictException:

There is a conflict while performing this action.

ValidationException:

The input fails to satisfy the constraints specified by the Amazon Web Services service.

UnauthorizedException:

You do not have permission to perform this action.