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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
ListProjects ( array $params = [] )
Lists Amazon DataZone projects.
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.
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.
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
ListDataProductRevisions
ListDataSourceRunActivities
ListDataSourceRuns
ListDataSources
ListDomainUnitsForParent
ListDomains
ListEntityOwners
ListEnvironmentActions
ListEnvironmentBlueprintConfigurations
ListEnvironmentBlueprints
ListEnvironmentProfiles
ListEnvironments
ListLineageNodeHistory
ListMetadataGenerationRuns
ListNotifications
ListPolicyGrants
ListProjectMemberships
ListProjects
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>',
    'id' => '<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.

id
Required: Yes
Type: string

The identifier of 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' => [
        ],
        'createEnvironmentProfile' => [
            'domainUnitId' => '<string>',
        ],
        'createFormType' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createGlossary' => [
            'includeChildDomainUnits' => true || false,
        ],
        'createProject' => [
            'includeChildDomainUnits' => true || false,
        ],
        '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', // REQUIRED
    'principal' => [ // REQUIRED
        'domainUnit' => [
            'domainUnitDesignation' => 'OWNER', // REQUIRED
            'domainUnitGrantFilter' => [
                'allDomainUnitsGrantFilter' => [
                ],
            ],
            'domainUnitIdentifier' => '<string>',
        ],
        'group' => [
            'groupIdentifier' => '<string>',
        ],
        'project' => [
            'projectDesignation' => 'OWNER|CONTRIBUTOR', // 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.

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,
            'dataAccessRole' => '<string>',
            'relationalFilterConfigurations' => [ // REQUIRED
                [
                    'databaseName' => '<string>', // REQUIRED
                    'filterExpressions' => [
                        [
                            'expression' => '<string>', // REQUIRED
                            'type' => 'INCLUDE|EXCLUDE', // REQUIRED
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
        'redshiftRunConfiguration' => [
            'dataAccessRole' => '<string>',
            'redshiftCredentialConfiguration' => [ // REQUIRED
                'secretManagerArn' => '<string>', // REQUIRED
            ],
            'redshiftStorage' => [ // REQUIRED
                'redshiftClusterSource' => [
                    'clusterName' => '<string>', // REQUIRED
                ],
                'redshiftServerlessSource' => [
                    'workgroupName' => '<string>', // REQUIRED
                ],
            ],
            'relationalFilterConfigurations' => [ // REQUIRED
                [
                    'databaseName' => '<string>', // REQUIRED
                    'filterExpressions' => [
                        [
                            'expression' => '<string>', // REQUIRED
                            'type' => 'INCLUDE|EXCLUDE', // REQUIRED
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
    ],
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'enableSetting' => 'ENABLED|DISABLED',
    'environmentIdentifier' => '<string>', // REQUIRED
    '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.

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
Required: Yes
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,
            'dataAccessRole' => '<string>',
            'region' => '<string>',
            'relationalFilterConfigurations' => [
                [
                    'databaseName' => '<string>',
                    'filterExpressions' => [
                        [
                            'expression' => '<string>',
                            'type' => 'INCLUDE|EXCLUDE',
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
        'redshiftRunConfiguration' => [
            'accountId' => '<string>',
            'dataAccessRole' => '<string>',
            'redshiftCredentialConfiguration' => [
                'secretManagerArn' => '<string>',
            ],
            'redshiftStorage' => [
                'redshiftClusterSource' => [
                    'clusterName' => '<string>',
                ],
                'redshiftServerlessSource' => [
                    'workgroupName' => '<string>',
                ],
            ],
            'region' => '<string>',
            'relationalFilterConfigurations' => [
                [
                    'databaseName' => '<string>',
                    'filterExpressions' => [
                        [
                            'expression' => '<string>',
                            'type' => 'INCLUDE|EXCLUDE',
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
    ],
    'createdAt' => <DateTime>,
    '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.

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
Required: Yes
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
    'kmsKeyIdentifier' => '<string>',
    'name' => '<string>', // REQUIRED
    '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.

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.

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>',
    'id' => '<string>',
    'kmsKeyIdentifier' => '<string>',
    'name' => '<string>',
    'portalUrl' => '<string>',
    'rootDomainUnitId' => '<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.

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.

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([
    'description' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentAccountIdentifier' => '<string>',
    'environmentAccountRegion' => '<string>',
    'environmentBlueprintIdentifier' => '<string>',
    'environmentProfileIdentifier' => '<string>', // REQUIRED
    'glossaryTerms' => ['<string>', ...],
    'name' => '<string>', // REQUIRED
    'projectIdentifier' => '<string>', // REQUIRED
    'userParameters' => [
        [
            'name' => '<string>',
            'value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

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

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
]);

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.

Result Syntax

[
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'description' => '<string>',
    'domainId' => '<string>',
    'domainUnitId' => '<string>',
    'failureReasons' => [
        [
            'code' => '<string>',
            'message' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED',
]

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.

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.

projectStatus
Type: string

The status of the Amazon DataZone project that was created.

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', // 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.

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>', // REQUIRED
]);

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

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>',
    'id' => '<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.

id
Required: Yes
Type: string

The ID of 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
Required: Yes
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.

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,
            'dataAccessRole' => '<string>',
            'region' => '<string>',
            'relationalFilterConfigurations' => [
                [
                    'databaseName' => '<string>',
                    'filterExpressions' => [
                        [
                            'expression' => '<string>',
                            'type' => 'INCLUDE|EXCLUDE',
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
        'redshiftRunConfiguration' => [
            'accountId' => '<string>',
            'dataAccessRole' => '<string>',
            'redshiftCredentialConfiguration' => [
                'secretManagerArn' => '<string>',
            ],
            'redshiftStorage' => [
                'redshiftClusterSource' => [
                    'clusterName' => '<string>',
                ],
                'redshiftServerlessSource' => [
                    'workgroupName' => '<string>',
                ],
            ],
            'region' => '<string>',
            'relationalFilterConfigurations' => [
                [
                    'databaseName' => '<string>',
                    'filterExpressions' => [
                        [
                            'expression' => '<string>',
                            'type' => 'INCLUDE|EXCLUDE',
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
    ],
    'createdAt' => <DateTime>,
    '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.

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

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.

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,
            'dataAccessRole' => '<string>',
            'region' => '<string>',
            'relationalFilterConfigurations' => [
                [
                    'databaseName' => '<string>',
                    'filterExpressions' => [
                        [
                            'expression' => '<string>',
                            'type' => 'INCLUDE|EXCLUDE',
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
        'redshiftRunConfiguration' => [
            'accountId' => '<string>',
            'dataAccessRole' => '<string>',
            'redshiftCredentialConfiguration' => [
                'secretManagerArn' => '<string>',
            ],
            'redshiftStorage' => [
                'redshiftClusterSource' => [
                    'clusterName' => '<string>',
                ],
                'redshiftServerlessSource' => [
                    'workgroupName' => '<string>',
                ],
            ],
            'region' => '<string>',
            'relationalFilterConfigurations' => [
                [
                    'databaseName' => '<string>',
                    'filterExpressions' => [
                        [
                            'expression' => '<string>',
                            'type' => 'INCLUDE|EXCLUDE',
                        ],
                        // ...
                    ],
                    'schemaName' => '<string>',
                ],
                // ...
            ],
        ],
    ],
    'createdAt' => <DateTime>,
    '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.

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
Required: Yes
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>',
    '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.

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>',
    'id' => '<string>',
    'kmsKeyIdentifier' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'portalUrl' => '<string>',
    'rootDomainUnitId' => '<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.

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.

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>',
    '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.

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.

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>',
    'failureReasons' => [
        [
            'code' => '<string>',
            'message' => '<string>',
        ],
        // ...
    ],
    'glossaryTerms' => ['<string>', ...],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED',
]

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.

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.

projectStatus
Type: string

The status 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.

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>',
    'id' => '<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.

id
Required: Yes
Type: string

The identifier of 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
Required: Yes
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.

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

ListDataSourceRuns

$result = $client->listDataSourceRuns([/* ... */]);
$promise = $client->listDataSourceRunsAsync([/* ... */]);

Lists data source runs in Amazon DataZone.

Parameter Syntax

$result = $client->listDataSourceRuns([
    'dataSourceIdentifier' => '<string>', // REQUIRED
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS',
]);

Parameter Details

Members
dataSourceIdentifier
Required: Yes
Type: string

The identifier of the data source.

domainIdentifier
Required: Yes
Type: string

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

maxResults
Type: int

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

nextToken
Type: string

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

status
Type: string

The status of the data source.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'dataSourceId' => '<string>',
            'errorMessage' => [
                'errorDetail' => '<string>',
                'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION',
            ],
            'id' => '<string>',
            'projectId' => '<string>',
            'runStatisticsForAssets' => [
                'added' => <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>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of DataSourceRunSummary structures

The results of the ListDataSourceRuns action.

nextToken
Type: string

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

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.

ListDataSources

$result = $client->listDataSources([/* ... */]);
$promise = $client->listDataSourcesAsync([/* ... */]);

Lists data sources in Amazon DataZone.

Parameter Syntax

$result = $client->listDataSources([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>',
    'maxResults' => <integer>,
    'name' => '<string>',
    'nextToken' => '<string>',
    'projectIdentifier' => '<string>', // REQUIRED
    'status' => 'CREATING|FAILED_CREATION|READY|UPDATING|FAILED_UPDATE|RUNNING|DELETING|FAILED_DELETION',
    'type' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Type: string

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

maxResults
Type: int

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

name
Type: string

The name of the data source.

nextToken
Type: string

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

projectIdentifier
Required: Yes
Type: string

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

status
Type: string

The status of the data source.

type
Type: string

The type of the data source.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'dataSourceId' => '<string>',
            'domainId' => '<string>',
            'enableSetting' => 'ENABLED|DISABLED',
            'environmentId' => '<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>',
            '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>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of DataSourceSummary structures

The results of the ListDataSources action.

nextToken
Type: string

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

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.

ListDomainUnitsForParent

$result = $client->listDomainUnitsForParent([/* ... */]);
$promise = $client->listDomainUnitsForParentAsync([/* ... */]);

Lists child domain units for the specified parent domain unit.

Parameter Syntax

$result = $client->listDomainUnitsForParent([
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'parentDomainUnitIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain in which you want to list domain units for a parent domain unit.

maxResults
Type: int

The maximum number of domain units to return in a single call to ListDomainUnitsForParent. When the number of domain units 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 ListDomainUnitsForParent to list the next set of domain units.

nextToken
Type: string

When the number of domain units 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 domain units, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListDomainUnitsForParent to list the next set of domain units.

parentDomainUnitIdentifier
Required: Yes
Type: string

The ID of the parent domain unit.

Result Syntax

[
    'items' => [
        [
            'id' => '<string>',
            'name' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of DomainUnitSummary structures

The results returned by this action.

nextToken
Type: string

When the number of domain units 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 domain units, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListDomainUnitsForParent to list the next set of domain units.

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.

ListDomains

$result = $client->listDomains([/* ... */]);
$promise = $client->listDomainsAsync([/* ... */]);

Lists Amazon DataZone domains.

Parameter Syntax

$result = $client->listDomains([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED',
]);

Parameter Details

Members
maxResults
Type: int

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

nextToken
Type: string

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

status
Type: string

The status of the data source.

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'description' => '<string>',
            'id' => '<string>',
            'lastUpdatedAt' => <DateTime>,
            'managedAccountId' => '<string>',
            'name' => '<string>',
            'portalUrl' => '<string>',
            'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of DomainSummary structures

The results of the ListDomains action.

nextToken
Type: string

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

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.

ListEntityOwners

$result = $client->listEntityOwners([/* ... */]);
$promise = $client->listEntityOwnersAsync([/* ... */]);

Lists the entity (domain units) owners.

Parameter Syntax

$result = $client->listEntityOwners([
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityType' => 'DOMAIN_UNIT', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to list entity owners.

entityIdentifier
Required: Yes
Type: string

The ID of the entity that you want to list.

entityType
Required: Yes
Type: string

The type of the entity that you want to list.

maxResults
Type: int

The maximum number of entities to return in a single call to ListEntityOwners. When the number of entities 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 ListEntityOwners to list the next set of entities.

nextToken
Type: string

When the number of entities 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 entities, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListEntityOwners to list the next set of entities.

Result Syntax

[
    'nextToken' => '<string>',
    'owners' => [
        [
            'group' => [
                'groupId' => '<string>',
            ],
            'user' => [
                'userId' => '<string>',
            ],
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

When the number of entities 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 entities, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListEntityOwners to list the next set of entities.

owners
Required: Yes
Type: Array of OwnerPropertiesOutput structures

The owners of the entity.

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.

ListEnvironmentActions

$result = $client->listEnvironmentActions([/* ... */]);
$promise = $client->listEnvironmentActionsAsync([/* ... */]);

Lists existing environment actions.

Parameter Syntax

$result = $client->listEnvironmentActions([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain in which the environment actions are listed.

environmentIdentifier
Required: Yes
Type: string

The ID of the envrironment whose environment actions are listed.

maxResults
Type: int

The maximum number of environment actions to return in a single call to ListEnvironmentActions. When the number of environment actions 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 ListEnvironmentActions to list the next set of environment actions.

nextToken
Type: string

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

Result Syntax

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

Result Details

Members
items
Type: Array of EnvironmentActionSummary structures

The results of ListEnvironmentActions.

nextToken
Type: string

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

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.

ListEnvironmentBlueprintConfigurations

$result = $client->listEnvironmentBlueprintConfigurations([/* ... */]);
$promise = $client->listEnvironmentBlueprintConfigurationsAsync([/* ... */]);

Lists blueprint configurations for a Amazon DataZone environment.

Parameter Syntax

$result = $client->listEnvironmentBlueprintConfigurations([
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

maxResults
Type: int

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

nextToken
Type: string

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

Result Syntax

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

Result Details

Members
items
Type: Array of EnvironmentBlueprintConfigurationItem structures

The results of the ListEnvironmentBlueprintConfigurations action.

nextToken
Type: string

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

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.

ListEnvironmentBlueprints

$result = $client->listEnvironmentBlueprints([/* ... */]);
$promise = $client->listEnvironmentBlueprintsAsync([/* ... */]);

Lists blueprints in an Amazon DataZone environment.

Parameter Syntax

$result = $client->listEnvironmentBlueprints([
    'domainIdentifier' => '<string>', // REQUIRED
    'managed' => true || false,
    'maxResults' => <integer>,
    'name' => '<string>',
    'nextToken' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

managed
Type: boolean

Specifies whether the environment blueprint is managed by Amazon DataZone.

maxResults
Type: int

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

name
Type: string

The name of the Amazon DataZone environment.

nextToken
Type: string

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

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'description' => '<string>',
            'id' => '<string>',
            'name' => '<string>',
            'provider' => '<string>',
            'provisioningProperties' => [
                'cloudFormation' => [
                    'templateUrl' => '<string>',
                ],
            ],
            'updatedAt' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of EnvironmentBlueprintSummary structures

The results of the ListEnvironmentBlueprints action.

nextToken
Type: string

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

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.

ListEnvironmentProfiles

$result = $client->listEnvironmentProfiles([/* ... */]);
$promise = $client->listEnvironmentProfilesAsync([/* ... */]);

Lists Amazon DataZone environment profiles.

Parameter Syntax

$result = $client->listEnvironmentProfiles([
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentBlueprintIdentifier' => '<string>',
    'maxResults' => <integer>,
    'name' => '<string>',
    'nextToken' => '<string>',
    'projectIdentifier' => '<string>',
]);

Parameter Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

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

domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

environmentBlueprintIdentifier
Type: string

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

maxResults
Type: int

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

name
Type: string

nextToken
Type: string

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

projectIdentifier
Type: string

The identifier of the Amazon DataZone project.

Result Syntax

[
    'items' => [
        [
            'awsAccountId' => '<string>',
            'awsAccountRegion' => '<string>',
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'description' => '<string>',
            'domainId' => '<string>',
            'environmentBlueprintId' => '<string>',
            'id' => '<string>',
            'name' => '<string>',
            'projectId' => '<string>',
            'updatedAt' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of EnvironmentProfileSummary structures

The results of the ListEnvironmentProfiles action.

nextToken
Type: string

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

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.

ListEnvironments

$result = $client->listEnvironments([/* ... */]);
$promise = $client->listEnvironmentsAsync([/* ... */]);

Lists Amazon DataZone environments.

Parameter Syntax

$result = $client->listEnvironments([
    'awsAccountId' => '<string>',
    'awsAccountRegion' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentBlueprintIdentifier' => '<string>',
    'environmentProfileIdentifier' => '<string>',
    'maxResults' => <integer>,
    'name' => '<string>',
    'nextToken' => '<string>',
    'projectIdentifier' => '<string>', // REQUIRED
    'provider' => '<string>',
    'status' => 'ACTIVE|CREATING|UPDATING|DELETING|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED|VALIDATION_FAILED|SUSPENDED|DISABLED|EXPIRED|DELETED|INACCESSIBLE',
]);

Parameter Details

Members
awsAccountId
Type: string

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

awsAccountRegion
Type: string

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

domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

environmentBlueprintIdentifier
Type: string

The identifier of the Amazon DataZone blueprint.

environmentProfileIdentifier
Type: string

The identifier of the environment profile.

maxResults
Type: int

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

name
Type: string

The name of the environment.

nextToken
Type: string

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

projectIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone project.

provider
Type: string

The provider of the environment.

status
Type: string

The status of the environments that you want to list.

Result Syntax

[
    'items' => [
        [
            'awsAccountId' => '<string>',
            'awsAccountRegion' => '<string>',
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'description' => '<string>',
            'domainId' => '<string>',
            'environmentProfileId' => '<string>',
            'id' => '<string>',
            'name' => '<string>',
            'projectId' => '<string>',
            'provider' => '<string>',
            'status' => 'ACTIVE|CREATING|UPDATING|DELETING|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED|VALIDATION_FAILED|SUSPENDED|DISABLED|EXPIRED|DELETED|INACCESSIBLE',
            'updatedAt' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of EnvironmentSummary structures

The results of the ListEnvironments action.

nextToken
Type: string

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

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.

ListLineageNodeHistory

$result = $client->listLineageNodeHistory([/* ... */]);
$promise = $client->listLineageNodeHistoryAsync([/* ... */]);

Lists the history of the specified data lineage node.

Parameter Syntax

$result = $client->listLineageNodeHistory([
    'direction' => 'UPSTREAM|DOWNSTREAM',
    'domainIdentifier' => '<string>', // REQUIRED
    'eventTimestampGTE' => <integer || string || DateTime>,
    'eventTimestampLTE' => <integer || string || DateTime>,
    'identifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'sortOrder' => 'ASCENDING|DESCENDING',
]);

Parameter Details

Members
direction
Type: string

The direction of the data lineage node refers to the lineage node having neighbors in that direction. For example, if direction is UPSTREAM, the ListLineageNodeHistory API responds with historical versions with upstream neighbors only.

domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to list the history of the specified data lineage node.

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

Specifies whether the action is to return data lineage node history from the time after the event timestamp.

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

Specifies whether the action is to return data lineage node history from the time prior of the event timestamp.

identifier
Required: Yes
Type: string

The ID of the data lineage node whose history you want to list.

maxResults
Type: int

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

nextToken
Type: string

When the number of history items 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 items, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListLineageNodeHistory to list the next set of items.

sortOrder
Type: string

The order by which you want data lineage node history to be sorted.

Result Syntax

[
    'nextToken' => '<string>',
    'nodes' => [
        [
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'description' => '<string>',
            'domainId' => '<string>',
            'eventTimestamp' => <DateTime>,
            'id' => '<string>',
            'name' => '<string>',
            'sourceIdentifier' => '<string>',
            'typeName' => '<string>',
            'typeRevision' => '<string>',
            'updatedAt' => <DateTime>,
            'updatedBy' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

When the number of history items 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 items, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListLineageNodeHistory to list the next set of items.

nodes
Type: Array of LineageNodeSummary structures

The nodes returned by the ListLineageNodeHistory 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.

ListMetadataGenerationRuns

$result = $client->listMetadataGenerationRuns([/* ... */]);
$promise = $client->listMetadataGenerationRunsAsync([/* ... */]);

Lists all metadata generation runs.

Parameter Syntax

$result = $client->listMetadataGenerationRuns([
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'SUBMITTED|IN_PROGRESS|CANCELED|SUCCEEDED|FAILED',
    'type' => 'BUSINESS_DESCRIPTIONS',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the Amazon DataZone domain where you want to list metadata generation runs.

maxResults
Type: int

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

nextToken
Type: string

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

status
Type: string

The status of the metadata generation runs.

type
Type: string

The type of the metadata generation runs.

Result Syntax

[
    'items' => [
        [
            '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',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Type: Array of MetadataGenerationRunItem structures

The results of the ListMetadataGenerationRuns action.

nextToken
Type: string

When the number of metadata generation runs is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of metadata generation runs, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListMetadataGenerationRuns 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.

ListNotifications

$result = $client->listNotifications([/* ... */]);
$promise = $client->listNotificationsAsync([/* ... */]);

Lists all Amazon DataZone notifications.

Parameter Syntax

$result = $client->listNotifications([
    'afterTimestamp' => <integer || string || DateTime>,
    'beforeTimestamp' => <integer || string || DateTime>,
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'subjects' => ['<string>', ...],
    'taskStatus' => 'ACTIVE|INACTIVE',
    'type' => 'TASK|EVENT', // REQUIRED
]);

Parameter Details

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

The time after which you want to list notifications.

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

The time before which you want to list notifications.

domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

maxResults
Type: int

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

nextToken
Type: string

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

subjects
Type: Array of strings

The subjects of notifications.

taskStatus
Type: string

The task status of notifications.

type
Required: Yes
Type: string

The type of notifications.

Result Syntax

[
    'nextToken' => '<string>',
    'notifications' => [
        [
            'actionLink' => '<string>',
            'creationTimestamp' => <DateTime>,
            'domainIdentifier' => '<string>',
            'identifier' => '<string>',
            'lastUpdatedTimestamp' => <DateTime>,
            'message' => '<string>',
            'metadata' => ['<string>', ...],
            'status' => 'ACTIVE|INACTIVE',
            'title' => '<string>',
            'topic' => [
                'resource' => [
                    'id' => '<string>',
                    'name' => '<string>',
                    'type' => 'PROJECT',
                ],
                'role' => 'PROJECT_OWNER|PROJECT_CONTRIBUTOR|PROJECT_VIEWER|DOMAIN_OWNER|PROJECT_SUBSCRIBER',
                'subject' => '<string>',
            ],
            'type' => 'TASK|EVENT',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

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

notifications
Type: Array of NotificationOutput structures

The results of the ListNotifications 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.

ListPolicyGrants

$result = $client->listPolicyGrants([/* ... */]);
$promise = $client->listPolicyGrantsAsync([/* ... */]);

Lists policy grants.

Parameter Syntax

$result = $client->listPolicyGrants([
    'domainIdentifier' => '<string>', // REQUIRED
    'entityIdentifier' => '<string>', // REQUIRED
    'entityType' => 'DOMAIN_UNIT|ENVIRONMENT_BLUEPRINT_CONFIGURATION|ENVIRONMENT_PROFILE', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    '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', // REQUIRED
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The ID of the domain where you want to list policy grants.

entityIdentifier
Required: Yes
Type: string

The ID of the entity for which you want to list policy grants.

entityType
Required: Yes
Type: string

The type of entity for which you want to list policy grants.

maxResults
Type: int

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

nextToken
Type: string

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

policyType
Required: Yes
Type: string

The type of policy that you want to list.

Result Syntax

[
    'grantList' => [
        [
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'detail' => [
                'addToProjectMemberPool' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'createAssetType' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'createDomainUnit' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'createEnvironment' => [
                ],
                'createEnvironmentProfile' => [
                    'domainUnitId' => '<string>',
                ],
                'createFormType' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'createGlossary' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'createProject' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'delegateCreateEnvironmentProfile' => [
                ],
                'overrideDomainUnitOwners' => [
                    'includeChildDomainUnits' => true || false,
                ],
                'overrideProjectOwners' => [
                    'includeChildDomainUnits' => true || false,
                ],
            ],
            'principal' => [
                'domainUnit' => [
                    'domainUnitDesignation' => 'OWNER',
                    'domainUnitGrantFilter' => [
                        'allDomainUnitsGrantFilter' => [
                        ],
                    ],
                    'domainUnitIdentifier' => '<string>',
                ],
                'group' => [
                    'groupIdentifier' => '<string>',
                ],
                'project' => [
                    'projectDesignation' => 'OWNER|CONTRIBUTOR',
                    'projectGrantFilter' => [
                        'domainUnitFilter' => [
                            'domainUnit' => '<string>',
                            'includeChildDomainUnits' => true || false,
                        ],
                    ],
                    'projectIdentifier' => '<string>',
                ],
                'user' => [
                    'allUsersGrantFilter' => [
                    ],
                    'userIdentifier' => '<string>',
                ],
            ],
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
grantList
Required: Yes
Type: Array of PolicyGrantMember structures

The results of this action - the listed grants.

nextToken
Type: string

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

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.

ListProjectMemberships

$result = $client->listProjectMemberships([/* ... */]);
$promise = $client->listProjectMembershipsAsync([/* ... */]);

Lists all members of the specified project.

Parameter Syntax

$result = $client->listProjectMemberships([
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'projectIdentifier' => '<string>', // REQUIRED
    'sortBy' => 'NAME',
    'sortOrder' => 'ASCENDING|DESCENDING',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

maxResults
Type: int

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

nextToken
Type: string

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

projectIdentifier
Required: Yes
Type: string

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

sortBy
Type: string

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

sortOrder
Type: string

The sort order of the project memberships.

Result Syntax

[
    'members' => [
        [
            'designation' => 'PROJECT_OWNER|PROJECT_CONTRIBUTOR',
            'memberDetails' => [
                'group' => [
                    'groupId' => '<string>',
                ],
                'user' => [
                    'userId' => '<string>',
                ],
            ],
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
members
Required: Yes
Type: Array of ProjectMember structures

The members of the project.

nextToken
Type: string

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

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.

ListProjects

$result = $client->listProjects([/* ... */]);
$promise = $client->listProjectsAsync([/* ... */]);

Lists Amazon DataZone projects.

Parameter Syntax

$result = $client->listProjects([
    'domainIdentifier' => '<string>', // REQUIRED
    'groupIdentifier' => '<string>',
    'maxResults' => <integer>,
    'name' => '<string>',
    'nextToken' => '<string>',
    'userIdentifier' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

groupIdentifier
Type: string

The identifier of a group.

maxResults
Type: int

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

name
Type: string

The name of the project.

nextToken
Type: string

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

userIdentifier
Type: string

The identifier of the Amazon DataZone user.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'description' => '<string>',
            'domainId' => '<string>',
            'domainUnitId' => '<string>',
            'failureReasons' => [
                [
                    'code' => '<string>',
                    'message' => '<string>',
                ],
                // ...
            ],
            'id' => '<string>',
            'name' => '<string>',
            'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED',
            'updatedAt' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Type: Array of ProjectSummary structures

The results of the ListProjects action.

nextToken
Type: string

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

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.

ListSubscriptionGrants

$result = $client->listSubscriptionGrants([/* ... */]);
$promise = $client->listSubscriptionGrantsAsync([/* ... */]);

Lists subscription grants.

Parameter Syntax

$result = $client->listSubscriptionGrants([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentId' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'owningProjectId' => '<string>',
    'sortBy' => 'CREATED_AT|UPDATED_AT',
    'sortOrder' => 'ASCENDING|DESCENDING',
    'subscribedListingId' => '<string>',
    'subscriptionId' => '<string>',
    'subscriptionTargetId' => '<string>',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

environmentId
Type: string

The identifier of the Amazon DataZone environment.

maxResults
Type: int

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

nextToken
Type: string

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

owningProjectId
Type: string

The ID of the owning project of the subscription grants.

sortBy
Type: string

Specifies the way of sorting the results of this action.

sortOrder
Type: string

Specifies the sort order of this action.

subscribedListingId
Type: string

The identifier of the subscribed listing.

subscriptionId
Type: string

The identifier of the subscription.

subscriptionTargetId
Type: string

The identifier of the subscription target.

Result Syntax

[
    'items' => [
        [
            '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>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of SubscriptionGrantSummary structures

The results of the ListSubscriptionGrants action.

nextToken
Type: string

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

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.

ListSubscriptionRequests

$result = $client->listSubscriptionRequests([/* ... */]);
$promise = $client->listSubscriptionRequestsAsync([/* ... */]);

Lists Amazon DataZone subscription requests.

Parameter Syntax

$result = $client->listSubscriptionRequests([
    'approverProjectId' => '<string>',
    'domainIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'owningProjectId' => '<string>',
    'sortBy' => 'CREATED_AT|UPDATED_AT',
    'sortOrder' => 'ASCENDING|DESCENDING',
    'status' => 'PENDING|ACCEPTED|REJECTED',
    'subscribedListingId' => '<string>',
]);

Parameter Details

Members
approverProjectId
Type: string

The identifier of the subscription request approver's project.

domainIdentifier
Required: Yes
Type: string

The identifier of the Amazon DataZone domain.

maxResults
Type: int

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

nextToken
Type: string

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

owningProjectId
Type: string

The identifier of the project for the subscription requests.

sortBy
Type: string

Specifies the way to sort the results of this action.

sortOrder
Type: string

Specifies the sort order for the results of this action.

status
Type: string

Specifies the status of the subscription requests.

This is not a required parameter, but if not specified, by default, Amazon DataZone returns only PENDING subscription requests.

subscribedListingId
Type: string

The identifier of the subscribed listing.

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'decisionComment' => '<string>',
            'domainId' => '<string>',
            'id' => '<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>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of SubscriptionRequestSummary structures

The results of the ListSubscriptionRequests action.

nextToken
Type: string

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

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.

ListSubscriptionTargets

$result = $client->listSubscriptionTargets([/* ... */]);
$promise = $client->listSubscriptionTargetsAsync([/* ... */]);

Lists subscription targets in Amazon DataZone.

Parameter Syntax

$result = $client->listSubscriptionTargets([
    'domainIdentifier' => '<string>', // REQUIRED
    'environmentIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'sortBy' => 'CREATED_AT|UPDATED_AT',
    'sortOrder' => 'ASCENDING|DESCENDING',
]);

Parameter Details

Members
domainIdentifier
Required: Yes
Type: string

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

environmentIdentifier
Required: Yes
Type: string

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

maxResults
Type: int

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

nextToken
Type: string

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

sortBy
Type: string

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

sortOrder
Type: string

Specifies the sort order for the results of this action.

Result Syntax

[
    'items' => [
        [
            '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>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
items
Required: Yes
Type: Array of SubscriptionTargetSummary structures

The results of the ListSubscriptionTargets action.

nextToken
Type: string