Amazon DataZone 2018-05-10
- 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
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
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
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
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
-
- Type: DataSourceConfigurationInput structure
Specifies the configuration of the data source. It can be set to either
glueRunConfiguration
orredshiftRunConfiguration
. - 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
-
- Type: DataSourceConfigurationOutput structure
Specifies the configuration of the data source. It can be set to either
glueRunConfiguration
orredshiftRunConfiguration
. - 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
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
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
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
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
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
-
- Type: DataSourceConfigurationOutput structure
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
-
- Type: DataSourceConfigurationOutput structure
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. IfsourceIdentifier
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
-
- Type: TimeSeriesDataPointFormOutput structure
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListAssetFilters
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 forMaxResults
that is less than the number of asset filters, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListAssetFilters
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 forMaxResults
that is less than the number of asset filters, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListAssetFilters
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListAssetRevisions
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 forMaxResults
that is less than the number of revisions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListAssetRevisions
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 forMaxResults
that is less than the number of revisions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListAssetRevisions
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListDataProductRevisions
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 forMaxResults
that is less than the number of data product revisions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataProductRevisions
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 forMaxResults
that is less than the number of data product revisions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataProductRevisions
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListDataSourceRunActivities
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 forMaxResults
that is less than the number of activities, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataSourceRunActivities
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 forMaxResults
that is less than the number of activities, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataSourceRunActivities
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListDataSourceRuns
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 forMaxResults
that is less than the number of runs, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataSourceRuns
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 forMaxResults
that is less than the number of runs, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataSourceRuns
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListDataSources
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 forMaxResults
that is less than the number of data sources, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataSources
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 forMaxResults
that is less than the number of data sources, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDataSources
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListDomains
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 forMaxResults
that is less than the number of domains, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDomains
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 forMaxResults
that is less than the number of domains, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListDomains
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListEntityOwners
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 forMaxResults
that is less than the number of entities, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEntityOwners
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 forMaxResults
that is less than the number of entities, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEntityOwners
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListEnvironmentActions
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 forMaxResults
that is less than the number of environment actions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentActions
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 forMaxResults
that is less than the number of environment actions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentActions
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListEnvironmentBlueprintConfigurations
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 forMaxResults
that is less than the number of configurations, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentBlueprintConfigurations
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 forMaxResults
that is less than the number of configurations, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentBlueprintConfigurations
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListEnvironmentBlueprints
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 forMaxResults
that is less than the number of blueprints in the environment, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentBlueprints
to 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 forMaxResults
that is less than the number of blueprints in the environment, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentBlueprints
to 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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListEnvironmentProfiles
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 forMaxResults
that is less than the number of environment profiles, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentProfiles
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 forMaxResults
that is less than the number of environment profiles, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironmentProfiles
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListEnvironments
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 forMaxResults
that is less than the number of environments, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironments
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 forMaxResults
that is less than the number of environments, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListEnvironments
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
, theListLineageNodeHistory
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListNotifications
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 forMaxResults
that is less than the number of notifications, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListNotifications
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 forMaxResults
that is less than the number of notifications, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListNotifications
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListPolicyGrants
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 forMaxResults
that is less than the number of grants, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListPolicyGrants
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 forMaxResults
that is less than the number of grants, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListPolicyGrants
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListProjectMemberships
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 forMaxResults
that is less than the number of memberships, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListProjectMemberships
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 forMaxResults
that is less than the number of memberships, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListProjectMemberships
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListProjects
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 forMaxResults
that is less than the number of projects, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListProjects
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 forMaxResults
that is less than the number of projects, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListProjects
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListSubscriptionGrants
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 forMaxResults
that is less than the number of subscription grants, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptionGrants
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 forMaxResults
that is less than the number of subscription grants, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptionGrants
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListSubscriptionRequests
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 forMaxResults
that is less than the number of subscription requests, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptionRequests
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 forMaxResults
that is less than the number of subscription requests, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptionRequests
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 ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListSubscriptionTargets
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 forMaxResults
that is less than the number of subscription targets, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptionTargets
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