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.
- CreateConnection ( array $params = [] )
- Creates a new connection.
- CreateDataProduct ( array $params = [] )
- Creates a data product.
- CreateDataProductRevision ( array $params = [] )
- Creates a data product revision.
- CreateDataSource ( array $params = [] )
- Creates an Amazon DataZone data source.
- CreateDomain ( array $params = [] )
- Creates an Amazon DataZone domain.
- CreateDomainUnit ( array $params = [] )
- Creates a domain unit in Amazon DataZone.
- CreateEnvironment ( array $params = [] )
- Create an Amazon DataZone environment.
- CreateEnvironmentAction ( array $params = [] )
- Creates an action for the environment, for example, creates a console link for an analytics tool that is available in this environment.
- CreateEnvironmentProfile ( array $params = [] )
- Creates an Amazon DataZone environment profile.
- CreateFormType ( array $params = [] )
- Creates a metadata form type.
- CreateGlossary ( array $params = [] )
- Creates an Amazon DataZone business glossary.
- CreateGlossaryTerm ( array $params = [] )
- Creates a business glossary term.
- CreateGroupProfile ( array $params = [] )
- Creates a group profile in Amazon DataZone.
- CreateListingChangeSet ( array $params = [] )
- Publishes a listing (a record of an asset at a given time) or removes a listing from the catalog.
- CreateProject ( array $params = [] )
- Creates an Amazon DataZone project.
- CreateProjectMembership ( array $params = [] )
- Creates a project membership in Amazon DataZone.
- CreateProjectProfile ( array $params = [] )
- Creates a project profile.
- CreateRule ( array $params = [] )
- Creates a rule in Amazon DataZone.
- CreateSubscriptionGrant ( array $params = [] )
- Creates a subsscription grant in Amazon DataZone.
- CreateSubscriptionRequest ( array $params = [] )
- Creates a subscription request in Amazon DataZone.
- CreateSubscriptionTarget ( array $params = [] )
- Creates a subscription target in Amazon DataZone.
- CreateUserProfile ( array $params = [] )
- Creates a user profile in Amazon DataZone.
- DeleteAsset ( array $params = [] )
- Deletes an asset in Amazon DataZone.
- DeleteAssetFilter ( array $params = [] )
- Deletes an asset filter.
- DeleteAssetType ( array $params = [] )
- Deletes an asset type in Amazon DataZone.
- DeleteConnection ( array $params = [] )
- Deletes and connection.
- DeleteDataProduct ( array $params = [] )
- Deletes a data product in Amazon DataZone.
- DeleteDataSource ( array $params = [] )
- Deletes a data source in Amazon DataZone.
- DeleteDomain ( array $params = [] )
- Deletes a Amazon DataZone domain.
- DeleteDomainUnit ( array $params = [] )
- Deletes a domain unit.
- DeleteEnvironment ( array $params = [] )
- Deletes an environment in Amazon DataZone.
- DeleteEnvironmentAction ( array $params = [] )
- Deletes an action for the environment, for example, deletes a console link for an analytics tool that is available in this environment.
- DeleteEnvironmentBlueprintConfiguration ( array $params = [] )
- Deletes the blueprint configuration in Amazon DataZone.
- DeleteEnvironmentProfile ( array $params = [] )
- Deletes an environment profile in Amazon DataZone.
- DeleteFormType ( array $params = [] )
- Delets and metadata form type in Amazon DataZone.
- DeleteGlossary ( array $params = [] )
- Deletes a business glossary in Amazon DataZone.
- DeleteGlossaryTerm ( array $params = [] )
- Deletes a business glossary term in Amazon DataZone.
- DeleteListing ( array $params = [] )
- Deletes a listing (a record of an asset at a given time).
- DeleteProject ( array $params = [] )
- Deletes a project in Amazon DataZone.
- DeleteProjectMembership ( array $params = [] )
- Deletes project membership in Amazon DataZone.
- DeleteProjectProfile ( array $params = [] )
- Deletes a project profile.
- DeleteRule ( array $params = [] )
- Deletes a rule in Amazon DataZone.
- DeleteSubscriptionGrant ( array $params = [] )
- Deletes and subscription grant in Amazon DataZone.
- DeleteSubscriptionRequest ( array $params = [] )
- Deletes a subscription request in Amazon DataZone.
- DeleteSubscriptionTarget ( array $params = [] )
- Deletes a subscription target in Amazon DataZone.
- DeleteTimeSeriesDataPoints ( array $params = [] )
- Deletes the specified time series form for the specified asset.
- DisassociateEnvironmentRole ( array $params = [] )
- Disassociates the environment role in Amazon DataZone.
- GetAsset ( array $params = [] )
- Gets an Amazon DataZone asset.
- GetAssetFilter ( array $params = [] )
- Gets an asset filter.
- GetAssetType ( array $params = [] )
- Gets an Amazon DataZone asset type.
- GetConnection ( array $params = [] )
- Gets a connection.
- GetDataProduct ( array $params = [] )
- Gets the data product.
- GetDataSource ( array $params = [] )
- Gets an Amazon DataZone data source.
- GetDataSourceRun ( array $params = [] )
- Gets an Amazon DataZone data source run.
- GetDomain ( array $params = [] )
- Gets an Amazon DataZone domain.
- GetDomainUnit ( array $params = [] )
- Gets the details of the specified domain unit.
- GetEnvironment ( array $params = [] )
- Gets an Amazon DataZone environment.
- GetEnvironmentAction ( array $params = [] )
- Gets the specified environment action.
- GetEnvironmentBlueprint ( array $params = [] )
- Gets an Amazon DataZone blueprint.
- GetEnvironmentBlueprintConfiguration ( array $params = [] )
- Gets the blueprint configuration in Amazon DataZone.
- GetEnvironmentCredentials ( array $params = [] )
- Gets the credentials of an environment in Amazon DataZone.
- GetEnvironmentProfile ( array $params = [] )
- Gets an evinronment profile in Amazon DataZone.
- GetFormType ( array $params = [] )
- Gets a metadata form type in Amazon DataZone.
- GetGlossary ( array $params = [] )
- Gets a business glossary in Amazon DataZone.
- GetGlossaryTerm ( array $params = [] )
- Gets a business glossary term in Amazon DataZone.
- GetGroupProfile ( array $params = [] )
- Gets a group profile in Amazon DataZone.
- GetIamPortalLoginUrl ( array $params = [] )
- Gets the data portal URL for the specified Amazon DataZone domain.
- GetJobRun ( array $params = [] )
- The details of the job run.
- GetLineageEvent ( array $params = [] )
- Describes the lineage event.
- GetLineageNode ( array $params = [] )
- Gets the data lineage node.
- GetListing ( array $params = [] )
- Gets a listing (a record of an asset at a given time).
- GetMetadataGenerationRun ( array $params = [] )
- Gets a metadata generation run in Amazon DataZone.
- GetProject ( array $params = [] )
- Gets a project in Amazon DataZone.
- GetProjectProfile ( array $params = [] )
- The details of the project profile.
- GetRule ( array $params = [] )
- Gets the details of a rule in Amazon DataZone.
- GetSubscription ( array $params = [] )
- Gets a subscription in Amazon DataZone.
- GetSubscriptionGrant ( array $params = [] )
- Gets the subscription grant in Amazon DataZone.
- GetSubscriptionRequestDetails ( array $params = [] )
- Gets the details of the specified subscription request.
- GetSubscriptionTarget ( array $params = [] )
- Gets the subscription target in Amazon DataZone.
- GetTimeSeriesDataPoint ( array $params = [] )
- Gets the existing data point for the asset.
- GetUserProfile ( array $params = [] )
- Gets a user profile in Amazon DataZone.
- ListAssetFilters ( array $params = [] )
- Lists asset filters.
- ListAssetRevisions ( array $params = [] )
- Lists the revisions for the asset.
- ListConnections ( array $params = [] )
- Lists connections.
- ListDataProductRevisions ( array $params = [] )
- Lists data product revisions.
- ListDataSourceRunActivities ( array $params = [] )
- Lists data source run activities.
- ListDataSourceRuns ( array $params = [] )
- Lists data source runs in Amazon DataZone.
- ListDataSources ( array $params = [] )
- Lists data sources in Amazon DataZone.
- ListDomainUnitsForParent ( array $params = [] )
- Lists child domain units for the specified parent domain unit.
- ListDomains ( array $params = [] )
- Lists Amazon DataZone domains.
- ListEntityOwners ( array $params = [] )
- Lists the entity (domain units) owners.
- ListEnvironmentActions ( array $params = [] )
- Lists existing environment actions.
- ListEnvironmentBlueprintConfigurations ( array $params = [] )
- Lists blueprint configurations for a Amazon DataZone environment.
- ListEnvironmentBlueprints ( array $params = [] )
- Lists blueprints in an Amazon DataZone environment.
- ListEnvironmentProfiles ( array $params = [] )
- Lists Amazon DataZone environment profiles.
- ListEnvironments ( array $params = [] )
- Lists Amazon DataZone environments.
- ListJobRuns ( array $params = [] )
- Lists job runs.
- ListLineageEvents ( array $params = [] )
- Lists lineage events.
- ListLineageNodeHistory ( array $params = [] )
- Lists the history of the specified data lineage node.
- ListMetadataGenerationRuns ( array $params = [] )
- Lists all metadata generation runs.
- ListNotifications ( array $params = [] )
- Lists all Amazon DataZone notifications.
- ListPolicyGrants ( array $params = [] )
- Lists policy grants.
- ListProjectMemberships ( array $params = [] )
- Lists all members of the specified project.
- ListProjectProfiles ( array $params = [] )
- Lists project profiles.
- ListProjects ( array $params = [] )
- Lists Amazon DataZone projects.
- ListRules ( array $params = [] )
- Lists existing rules.
- ListSubscriptionGrants ( array $params = [] )
- Lists subscription grants.
- ListSubscriptionRequests ( array $params = [] )
- Lists Amazon DataZone subscription requests.
- ListSubscriptionTargets ( array $params = [] )
- Lists subscription targets in Amazon DataZone.
- ListSubscriptions ( array $params = [] )
- Lists subscriptions in Amazon DataZone.
- ListTagsForResource ( array $params = [] )
- Lists tags for the specified resource in Amazon DataZone.
- ListTimeSeriesDataPoints ( array $params = [] )
- Lists time series data points.
- PostLineageEvent ( array $params = [] )
- Posts a data lineage event.
- PostTimeSeriesDataPoints ( array $params = [] )
- Posts time series data points to Amazon DataZone for the specified asset.
- PutEnvironmentBlueprintConfiguration ( array $params = [] )
- Writes the configuration for the specified environment blueprint in Amazon DataZone.
- RejectPredictions ( array $params = [] )
- Rejects automatically generated business-friendly metadata for your Amazon DataZone assets.
- RejectSubscriptionRequest ( array $params = [] )
- Rejects the specified subscription request.
- RemoveEntityOwner ( array $params = [] )
- Removes an owner from an entity.
- RemovePolicyGrant ( array $params = [] )
- Removes a policy grant.
- RevokeSubscription ( array $params = [] )
- Revokes a specified subscription in Amazon DataZone.
- Search ( array $params = [] )
- Searches for assets in Amazon DataZone.
- SearchGroupProfiles ( array $params = [] )
- Searches group profiles in Amazon DataZone.
- SearchListings ( array $params = [] )
- Searches listings (records of an asset at a given time) in Amazon DataZone.
- SearchTypes ( array $params = [] )
- Searches for types in Amazon DataZone.
- SearchUserProfiles ( array $params = [] )
- Searches user profiles in Amazon DataZone.
- StartDataSourceRun ( array $params = [] )
- Start the run of the specified data source in Amazon DataZone.
- StartMetadataGenerationRun ( array $params = [] )
- Starts the metadata generation run.
- TagResource ( array $params = [] )
- Tags a resource in Amazon DataZone.
- UntagResource ( array $params = [] )
- Untags a resource in Amazon DataZone.
- UpdateAssetFilter ( array $params = [] )
- Updates an asset filter.
- UpdateConnection ( array $params = [] )
- Updates a connection.
- UpdateDataSource ( array $params = [] )
- Updates the specified data source in Amazon DataZone.
- UpdateDomain ( array $params = [] )
- Updates a Amazon DataZone domain.
- UpdateDomainUnit ( array $params = [] )
- Updates the domain unit.
- UpdateEnvironment ( array $params = [] )
- Updates the specified environment in Amazon DataZone.
- UpdateEnvironmentAction ( array $params = [] )
- Updates an environment action.
- UpdateEnvironmentProfile ( array $params = [] )
- Updates the specified environment profile in Amazon DataZone.
- UpdateGlossary ( array $params = [] )
- Updates the business glossary in Amazon DataZone.
- UpdateGlossaryTerm ( array $params = [] )
- Updates a business glossary term in Amazon DataZone.
- UpdateGroupProfile ( array $params = [] )
- Updates the specified group profile in Amazon DataZone.
- UpdateProject ( array $params = [] )
- Updates the specified project in Amazon DataZone.
- UpdateProjectProfile ( array $params = [] )
- Updates a project profile.
- UpdateRule ( array $params = [] )
- Updates a rule.
- UpdateSubscriptionGrantStatus ( array $params = [] )
- Updates the status of the specified subscription grant status in Amazon DataZone.
- UpdateSubscriptionRequest ( array $params = [] )
- Updates a specified subscription request in Amazon DataZone.
- UpdateSubscriptionTarget ( array $params = [] )
- Updates the specified subscription target in Amazon DataZone.
- UpdateUserProfile ( array $params = [] )
- Updates the specified user profile in Amazon DataZone.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
- ListAssetFilters
- ListAssetRevisions
- ListConnections
- ListDataProductRevisions
- ListDataSourceRunActivities
- ListDataSourceRuns
- ListDataSources
- ListDomainUnitsForParent
- ListDomains
- ListEntityOwners
- ListEnvironmentActions
- ListEnvironmentBlueprintConfigurations
- ListEnvironmentBlueprints
- ListEnvironmentProfiles
- ListEnvironments
- ListJobRuns
- ListLineageEvents
- ListLineageNodeHistory
- ListMetadataGenerationRuns
- ListNotifications
- ListPolicyGrants
- ListProjectMemberships
- ListProjectProfiles
- ListProjects
- ListRules
- ListSubscriptionGrants
- ListSubscriptionRequests
- ListSubscriptionTargets
- ListSubscriptions
- ListTimeSeriesDataPoints
- Search
- SearchGroupProfiles
- SearchListings
- SearchTypes
- SearchUserProfiles
Operations
AcceptPredictions
$result = $client->acceptPredictions
([/* ... */]); $promise = $client->acceptPredictionsAsync
([/* ... */]);
Accepts automatically generated business-friendly metadata for your Amazon DataZone assets.
Parameter Syntax
$result = $client->acceptPredictions([ 'acceptChoices' => [ [ 'editedValue' => '<string>', 'predictionChoice' => <integer>, 'predictionTarget' => '<string>', // REQUIRED ], // ... ], 'acceptRule' => [ 'rule' => 'ALL|NONE', 'threshold' => <float>, ], 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'revision' => '<string>', ]);
Parameter Details
Members
- acceptChoices
-
- Type: Array of AcceptChoice structures
Specifies the prediction (aka, the automatically generated piece of metadata) and the target (for example, a column name) that can be accepted.
- acceptRule
-
- Type: AcceptRule structure
Specifies the rule (or the conditions) under which a prediction can be accepted.
- clientToken
-
- Type: string
A unique, case-sensitive identifier to ensure idempotency of the request. This field is automatically populated if not provided.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- identifier
-
- Required: Yes
- Type: string
The identifier of the asset.
- revision
-
- Type: string
The revision that is to be made to the asset.
Result Syntax
[ 'assetId' => '<string>', 'domainId' => '<string>', 'revision' => '<string>', ]
Result Details
Members
- assetId
-
- Required: Yes
- Type: string
The ID of the asset.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- revision
-
- Required: Yes
- Type: string
The revision that is to be made to the asset.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
AcceptSubscriptionRequest
$result = $client->acceptSubscriptionRequest
([/* ... */]); $promise = $client->acceptSubscriptionRequestAsync
([/* ... */]);
Accepts a subscription request to a specific asset.
Parameter Syntax
$result = $client->acceptSubscriptionRequest([ 'assetScopes' => [ [ 'assetId' => '<string>', // REQUIRED 'filterIds' => ['<string>', ...], // REQUIRED ], // ... ], 'decisionComment' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assetScopes
-
- Type: Array of AcceptedAssetScope structures
The asset scopes of the accept subscription request.
- decisionComment
-
- Type: string
A description that specifies the reason for accepting the specified subscription request.
- domainIdentifier
-
- Required: Yes
- Type: string
The Amazon DataZone domain where the specified subscription request is being accepted.
- identifier
-
- Required: Yes
- Type: string
The unique identifier of the subscription request that is to be accepted.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'decisionComment' => '<string>', 'domainId' => '<string>', 'existingSubscriptionId' => '<string>', 'id' => '<string>', 'metadataForms' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', 'reviewerId' => '<string>', 'status' => 'PENDING|ACCEPTED|REJECTED', 'subscribedListings' => [ [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], // ... ], 'subscribedPrincipals' => [ [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], // ... ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp that specifies when the subscription request was accepted.
- createdBy
-
- Required: Yes
- Type: string
Specifies the Amazon DataZone user that accepted the specified subscription request.
- decisionComment
-
- Type: string
Specifies the reason for accepting the subscription request.
- domainId
-
- Required: Yes
- Type: string
The unique identifier of the Amazon DataZone domain where the specified subscription request was accepted.
- existingSubscriptionId
-
- Type: string
The ID of the existing subscription.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription request.
- metadataForms
-
- Type: Array of FormOutput structures
The metadata form in the subscription request.
- requestReason
-
- Required: Yes
- Type: string
Specifies the reason for requesting a subscription to the asset.
- reviewerId
-
- Type: string
Specifes the ID of the Amazon DataZone user who reviewed the subscription request.
- status
-
- Required: Yes
- Type: string
Specifies the status of the subscription request.
- subscribedListings
-
- Required: Yes
- Type: Array of SubscribedListing structures
Specifies the asset for which the subscription request was created.
- subscribedPrincipals
-
- Required: Yes
- Type: Array of SubscribedPrincipal structures
Specifies the Amazon DataZone users who are subscribed to the asset specified in the subscription request.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Specifies the timestamp when subscription request was updated.
- updatedBy
-
- Type: string
Specifies the Amazon DataZone user who updated the subscription request.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
AddEntityOwner
$result = $client->addEntityOwner
([/* ... */]); $promise = $client->addEntityOwnerAsync
([/* ... */]);
Adds the owner of an entity (a domain unit).
Parameter Syntax
$result = $client->addEntityOwner([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'entityIdentifier' => '<string>', // REQUIRED 'entityType' => 'DOMAIN_UNIT', // REQUIRED 'owner' => [ // REQUIRED 'group' => [ 'groupIdentifier' => '<string>', // REQUIRED ], 'user' => [ 'userIdentifier' => '<string>', // REQUIRED ], ], ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain in which you want to add the entity owner.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the entity to which you want to add an owner.
- entityType
-
- Required: Yes
- Type: string
The type of an entity.
- owner
-
- Required: Yes
- Type: OwnerProperties structure
The owner that you want to add to the entity.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
AddPolicyGrant
$result = $client->addPolicyGrant
([/* ... */]); $promise = $client->addPolicyGrantAsync
([/* ... */]);
Adds a policy grant (an authorization policy) to a specified entity, including domain units, environment blueprint configurations, or environment profiles.
Parameter Syntax
$result = $client->addPolicyGrant([ 'clientToken' => '<string>', 'detail' => [ // REQUIRED 'addToProjectMemberPool' => [ 'includeChildDomainUnits' => true || false, ], 'createAssetType' => [ 'includeChildDomainUnits' => true || false, ], 'createDomainUnit' => [ 'includeChildDomainUnits' => true || false, ], 'createEnvironment' => [ ], 'createEnvironmentFromBlueprint' => [ ], 'createEnvironmentProfile' => [ 'domainUnitId' => '<string>', ], 'createFormType' => [ 'includeChildDomainUnits' => true || false, ], 'createGlossary' => [ 'includeChildDomainUnits' => true || false, ], 'createProject' => [ 'includeChildDomainUnits' => true || false, ], 'createProjectFromProjectProfile' => [ 'includeChildDomainUnits' => true || false, 'projectProfiles' => ['<string>', ...], ], 'delegateCreateEnvironmentProfile' => [ ], 'overrideDomainUnitOwners' => [ 'includeChildDomainUnits' => true || false, ], 'overrideProjectOwners' => [ 'includeChildDomainUnits' => true || false, ], ], 'domainIdentifier' => '<string>', // REQUIRED 'entityIdentifier' => '<string>', // REQUIRED 'entityType' => 'DOMAIN_UNIT|ENVIRONMENT_BLUEPRINT_CONFIGURATION|ENVIRONMENT_PROFILE', // REQUIRED 'policyType' => 'CREATE_DOMAIN_UNIT|OVERRIDE_DOMAIN_UNIT_OWNERS|ADD_TO_PROJECT_MEMBER_POOL|OVERRIDE_PROJECT_OWNERS|CREATE_GLOSSARY|CREATE_FORM_TYPE|CREATE_ASSET_TYPE|CREATE_PROJECT|CREATE_ENVIRONMENT_PROFILE|DELEGATE_CREATE_ENVIRONMENT_PROFILE|CREATE_ENVIRONMENT|CREATE_ENVIRONMENT_FROM_BLUEPRINT|CREATE_PROJECT_FROM_PROJECT_PROFILE', // REQUIRED 'principal' => [ // REQUIRED 'domainUnit' => [ 'domainUnitDesignation' => 'OWNER', // REQUIRED 'domainUnitGrantFilter' => [ 'allDomainUnitsGrantFilter' => [ ], ], 'domainUnitIdentifier' => '<string>', ], 'group' => [ 'groupIdentifier' => '<string>', ], 'project' => [ 'projectDesignation' => 'OWNER|CONTRIBUTOR|PROJECT_CATALOG_STEWARD', // REQUIRED 'projectGrantFilter' => [ 'domainUnitFilter' => [ 'domainUnit' => '<string>', // REQUIRED 'includeChildDomainUnits' => true || false, ], ], 'projectIdentifier' => '<string>', ], 'user' => [ 'allUsersGrantFilter' => [ ], 'userIdentifier' => '<string>', ], ], ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- detail
-
- Required: Yes
- Type: PolicyGrantDetail structure
The details of the policy grant.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to add a policy grant.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the entity (resource) to which you want to add a policy grant.
- entityType
-
- Required: Yes
- Type: string
The type of entity (resource) to which the grant is added.
- policyType
-
- Required: Yes
- Type: string
The type of policy that you want to grant.
- principal
-
- Required: Yes
- Type: PolicyGrantPrincipal structure
The principal to whom the permissions are granted.
Result Syntax
[]
Result Details
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.
CreateConnection
$result = $client->createConnection
([/* ... */]); $promise = $client->createConnectionAsync
([/* ... */]);
Creates a new connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.
Parameter Syntax
$result = $client->createConnection([ 'awsLocation' => [ 'accessRole' => '<string>', 'awsAccountId' => '<string>', 'awsRegion' => '<string>', 'iamConnectionId' => '<string>', ], 'clientToken' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'props' => [ 'athenaProperties' => [ 'workgroupName' => '<string>', ], 'glueProperties' => [ 'glueConnectionInput' => [ 'athenaProperties' => ['<string>', ...], 'authenticationConfiguration' => [ 'authenticationType' => 'BASIC|OAUTH2|CUSTOM', 'basicAuthenticationCredentials' => [ 'password' => '<string>', 'userName' => '<string>', ], 'customAuthenticationCredentials' => ['<string>', ...], 'kmsKeyArn' => '<string>', 'oAuth2Properties' => [ 'authorizationCodeProperties' => [ 'authorizationCode' => '<string>', 'redirectUri' => '<string>', ], 'oAuth2ClientApplication' => [ 'aWSManagedClientApplicationReference' => '<string>', 'userManagedClientApplicationClientId' => '<string>', ], 'oAuth2Credentials' => [ 'accessToken' => '<string>', 'jwtToken' => '<string>', 'refreshToken' => '<string>', 'userManagedClientApplicationClientSecret' => '<string>', ], 'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER', 'tokenUrl' => '<string>', 'tokenUrlParametersMap' => ['<string>', ...], ], 'secretArn' => '<string>', ], 'connectionProperties' => ['<string>', ...], 'connectionType' => 'SNOWFLAKE|BIGQUERY|DOCUMENTDB|DYNAMODB|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SQLSERVER|TERADATA|VERTICA', 'description' => '<string>', 'matchCriteria' => '<string>', 'name' => '<string>', 'physicalConnectionRequirements' => [ 'availabilityZone' => '<string>', 'securityGroupIdList' => ['<string>', ...], 'subnetId' => '<string>', 'subnetIdList' => ['<string>', ...], ], 'pythonProperties' => ['<string>', ...], 'sparkProperties' => ['<string>', ...], 'validateCredentials' => true || false, 'validateForComputeEnvironments' => ['<string>', ...], ], ], 'hyperPodProperties' => [ 'clusterName' => '<string>', // REQUIRED ], 'iamProperties' => [ 'glueLineageSyncEnabled' => true || false, ], 'redshiftProperties' => [ 'credentials' => [ 'secretArn' => '<string>', 'usernamePassword' => [ 'password' => '<string>', // REQUIRED 'username' => '<string>', // REQUIRED ], ], 'databaseName' => '<string>', 'host' => '<string>', 'lineageSync' => [ 'enabled' => true || false, 'schedule' => [ 'schedule' => '<string>', ], ], 'port' => <integer>, 'storage' => [ 'clusterName' => '<string>', 'workgroupName' => '<string>', ], ], 'sparkEmrProperties' => [ 'computeArn' => '<string>', 'instanceProfileArn' => '<string>', 'javaVirtualEnv' => '<string>', 'logUri' => '<string>', 'pythonVirtualEnv' => '<string>', 'runtimeRole' => '<string>', 'trustedCertificatesS3Uri' => '<string>', ], 'sparkGlueProperties' => [ 'additionalArgs' => [ 'connection' => '<string>', ], 'glueConnectionName' => '<string>', 'glueVersion' => '<string>', 'idleTimeout' => <integer>, 'javaVirtualEnv' => '<string>', 'numberOfWorkers' => <integer>, 'pythonVirtualEnv' => '<string>', 'workerType' => '<string>', ], ], ]);
Parameter Details
Members
- awsLocation
-
- Type: AwsLocation structure
The location where the connection is created.
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
A connection description.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the connection is created.
- environmentIdentifier
-
- Required: Yes
- Type: string
The ID of the environment where the connection is created.
- name
-
- Required: Yes
- Type: string
The connection name.
- props
-
- Type: ConnectionPropertiesInput structure
The connection props.
Result Syntax
[ 'connectionId' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentId' => '<string>', 'name' => '<string>', 'physicalEndpoints' => [ [ 'awsLocation' => [ 'accessRole' => '<string>', 'awsAccountId' => '<string>', 'awsRegion' => '<string>', 'iamConnectionId' => '<string>', ], 'glueConnection' => [ 'athenaProperties' => ['<string>', ...], 'authenticationConfiguration' => [ 'authenticationType' => 'BASIC|OAUTH2|CUSTOM', 'oAuth2Properties' => [ 'authorizationCodeProperties' => [ 'authorizationCode' => '<string>', 'redirectUri' => '<string>', ], 'oAuth2ClientApplication' => [ 'aWSManagedClientApplicationReference' => '<string>', 'userManagedClientApplicationClientId' => '<string>', ], 'oAuth2Credentials' => [ 'accessToken' => '<string>', 'jwtToken' => '<string>', 'refreshToken' => '<string>', 'userManagedClientApplicationClientSecret' => '<string>', ], 'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER', 'tokenUrl' => '<string>', 'tokenUrlParametersMap' => ['<string>', ...], ], 'secretArn' => '<string>', ], 'compatibleComputeEnvironments' => ['<string>', ...], 'connectionProperties' => ['<string>', ...], 'connectionSchemaVersion' => <integer>, 'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', 'creationTime' => <DateTime>, 'description' => '<string>', 'lastConnectionValidationTime' => <DateTime>, 'lastUpdatedBy' => '<string>', 'lastUpdatedTime' => <DateTime>, 'matchCriteria' => ['<string>', ...], 'name' => '<string>', 'physicalConnectionRequirements' => [ 'availabilityZone' => '<string>', 'securityGroupIdList' => ['<string>', ...], 'subnetId' => '<string>', 'subnetIdList' => ['<string>', ...], ], 'pythonProperties' => ['<string>', ...], 'sparkProperties' => ['<string>', ...], 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'statusReason' => '<string>', ], 'glueConnectionName' => '<string>', 'host' => '<string>', 'port' => <integer>, 'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM', 'stage' => '<string>', ], // ... ], 'projectId' => '<string>', 'props' => [ 'athenaProperties' => [ 'workgroupName' => '<string>', ], 'glueProperties' => [ 'errorMessage' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', ], 'hyperPodProperties' => [ 'clusterArn' => '<string>', 'clusterName' => '<string>', 'orchestrator' => 'EKS|SLURM', ], 'iamProperties' => [ 'environmentId' => '<string>', 'glueLineageSyncEnabled' => true || false, ], 'redshiftProperties' => [ 'credentials' => [ 'secretArn' => '<string>', 'usernamePassword' => [ 'password' => '<string>', 'username' => '<string>', ], ], 'databaseName' => '<string>', 'isProvisionedSecret' => true || false, 'jdbcIamUrl' => '<string>', 'jdbcUrl' => '<string>', 'lineageSync' => [ 'enabled' => true || false, 'lineageJobId' => '<string>', 'schedule' => [ 'schedule' => '<string>', ], ], 'redshiftTempDir' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'storage' => [ 'clusterName' => '<string>', 'workgroupName' => '<string>', ], ], 'sparkEmrProperties' => [ 'computeArn' => '<string>', 'credentials' => [ 'password' => '<string>', 'username' => '<string>', ], 'credentialsExpiration' => <DateTime>, 'governanceType' => 'AWS_MANAGED|USER_MANAGED', 'instanceProfileArn' => '<string>', 'javaVirtualEnv' => '<string>', 'livyEndpoint' => '<string>', 'logUri' => '<string>', 'pythonVirtualEnv' => '<string>', 'runtimeRole' => '<string>', 'trustedCertificatesS3Uri' => '<string>', ], 'sparkGlueProperties' => [ 'additionalArgs' => [ 'connection' => '<string>', ], 'glueConnectionName' => '<string>', 'glueVersion' => '<string>', 'idleTimeout' => <integer>, 'javaVirtualEnv' => '<string>', 'numberOfWorkers' => <integer>, 'pythonVirtualEnv' => '<string>', 'workerType' => '<string>', ], ], 'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', ]
Result Details
Members
- connectionId
-
- Required: Yes
- Type: string
The ID of the connection.
- description
-
- Type: string
The connection description.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where the connection is created.
- domainUnitId
-
- Required: Yes
- Type: string
The ID of the domain unit where the connection is created.
- environmentId
-
- Type: string
The ID of the environment where the connection is created.
- name
-
- Required: Yes
- Type: string
The connection name.
- physicalEndpoints
-
- Required: Yes
- Type: Array of PhysicalEndpoint structures
The physical endpoints of the connection.
- projectId
-
- Type: string
The ID of the project where the connection is created.
- props
-
- Type: ConnectionPropertiesOutput structure
The connection props.
- type
-
- Required: Yes
- Type: string
The connection type.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateDataProduct
$result = $client->createDataProduct
([/* ... */]); $promise = $client->createDataProductAsync
([/* ... */]);
Creates a data product.
Parameter Syntax
$result = $client->createDataProduct([ 'clientToken' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'formsInput' => [ [ 'content' => '<string>', 'formName' => '<string>', // REQUIRED 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'items' => [ [ 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', // REQUIRED 'itemType' => 'ASSET', // REQUIRED 'revision' => '<string>', ], // ... ], 'name' => '<string>', // REQUIRED 'owningProjectIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
The description of the data product.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the data product is created.
- formsInput
-
- Type: Array of FormInput structures
The metadata forms of the data product.
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the data product.
- items
-
- Type: Array of DataProductItem structures
The data assets of the data product.
- name
-
- Required: Yes
- Type: string
The name of the data product.
- owningProjectIdentifier
-
- Required: Yes
- Type: string
The ID of the owning project of the data product.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'firstRevisionCreatedAt' => <DateTime>, 'firstRevisionCreatedBy' => '<string>', 'formsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'items' => [ [ 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', 'itemType' => 'ASSET', 'revision' => '<string>', ], // ... ], 'name' => '<string>', 'owningProjectId' => '<string>', 'revision' => '<string>', 'status' => 'CREATED|CREATING|CREATE_FAILED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data product was created.
- createdBy
-
- Type: string
The user who created the data product.
- description
-
- Type: string
The description of the data product.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where the data product lives.
- firstRevisionCreatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the first revision of the data product was created.
- firstRevisionCreatedBy
-
- Type: string
The user who created the first revision of the data product.
- formsOutput
-
- Type: Array of FormOutput structures
The metadata forms of the data product.
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the data product.
- id
-
- Required: Yes
- Type: string
The ID of the data product.
- items
-
- Type: Array of DataProductItem structures
The data assets of the data product.
- name
-
- Required: Yes
- Type: string
The name of the data product.
- owningProjectId
-
- Required: Yes
- Type: string
The ID of the owning project of the data product.
- revision
-
- Required: Yes
- Type: string
The revision of the data product.
- status
-
- Required: Yes
- Type: string
The status of the data product.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateDataProductRevision
$result = $client->createDataProductRevision
([/* ... */]); $promise = $client->createDataProductRevisionAsync
([/* ... */]);
Creates a data product revision.
Parameter Syntax
$result = $client->createDataProductRevision([ 'clientToken' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'formsInput' => [ [ 'content' => '<string>', 'formName' => '<string>', // REQUIRED 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', // REQUIRED 'items' => [ [ 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', // REQUIRED 'itemType' => 'ASSET', // REQUIRED 'revision' => '<string>', ], // ... ], 'name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
The description of the data product revision.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the data product revision is created.
- formsInput
-
- Type: Array of FormInput structures
The metadata forms of the data product revision.
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the data product revision.
- identifier
-
- Required: Yes
- Type: string
The ID of the data product revision.
- items
-
- Type: Array of DataProductItem structures
The data assets of the data product revision.
- name
-
- Required: Yes
- Type: string
The name of the data product revision.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'firstRevisionCreatedAt' => <DateTime>, 'firstRevisionCreatedBy' => '<string>', 'formsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'items' => [ [ 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', 'itemType' => 'ASSET', 'revision' => '<string>', ], // ... ], 'name' => '<string>', 'owningProjectId' => '<string>', 'revision' => '<string>', 'status' => 'CREATED|CREATING|CREATE_FAILED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data product revision is created.
- createdBy
-
- Type: string
The user who created the data product revision.
- description
-
- Type: string
The description of the data product revision.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where data product revision is created.
- firstRevisionCreatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the first revision of the data product is created.
- firstRevisionCreatedBy
-
- Type: string
The user who created the first revision of the data product.
- formsOutput
-
- Type: Array of FormOutput structures
The metadata forms of the data product revision.
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the data product revision.
- id
-
- Required: Yes
- Type: string
The ID of the data product revision.
- items
-
- Type: Array of DataProductItem structures
The data assets of the data product revision.
- name
-
- Required: Yes
- Type: string
The name of the data product revision.
- owningProjectId
-
- Required: Yes
- Type: string
The ID of the owning project of the data product revision.
- revision
-
- Required: Yes
- Type: string
The revision of the data product revision.
- status
-
- Required: Yes
- Type: string
The status of the data product revision.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateDataSource
$result = $client->createDataSource
([/* ... */]); $promise = $client->createDataSourceAsync
([/* ... */]);
Creates an Amazon DataZone data source.
Parameter Syntax
$result = $client->createDataSource([ 'assetFormsInput' => [ [ 'content' => '<string>', 'formName' => '<string>', // REQUIRED 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'clientToken' => '<string>', 'configuration' => [ 'glueRunConfiguration' => [ 'autoImportDataQualityResult' => true || false, 'catalogName' => '<string>', 'dataAccessRole' => '<string>', 'relationalFilterConfigurations' => [ // REQUIRED [ 'databaseName' => '<string>', // REQUIRED 'filterExpressions' => [ [ 'expression' => '<string>', // REQUIRED 'type' => 'INCLUDE|EXCLUDE', // REQUIRED ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'redshiftRunConfiguration' => [ 'dataAccessRole' => '<string>', 'redshiftCredentialConfiguration' => [ 'secretManagerArn' => '<string>', // REQUIRED ], 'redshiftStorage' => [ 'redshiftClusterSource' => [ 'clusterName' => '<string>', // REQUIRED ], 'redshiftServerlessSource' => [ 'workgroupName' => '<string>', // REQUIRED ], ], 'relationalFilterConfigurations' => [ // REQUIRED [ 'databaseName' => '<string>', // REQUIRED 'filterExpressions' => [ [ 'expression' => '<string>', // REQUIRED 'type' => 'INCLUDE|EXCLUDE', // REQUIRED ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'sageMakerRunConfiguration' => [ 'trackingAssets' => [ // REQUIRED '<SageMakerAssetType>' => ['<string>', ...], // ... ], ], ], 'connectionIdentifier' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'enableSetting' => 'ENABLED|DISABLED', 'environmentIdentifier' => '<string>', 'name' => '<string>', // REQUIRED 'projectIdentifier' => '<string>', // REQUIRED 'publishOnImport' => true || false, 'recommendation' => [ 'enableBusinessNameGeneration' => true || false, ], 'schedule' => [ 'schedule' => '<string>', 'timezone' => 'UTC|AFRICA_JOHANNESBURG|AMERICA_MONTREAL|AMERICA_SAO_PAULO|ASIA_BAHRAIN|ASIA_BANGKOK|ASIA_CALCUTTA|ASIA_DUBAI|ASIA_HONG_KONG|ASIA_JAKARTA|ASIA_KUALA_LUMPUR|ASIA_SEOUL|ASIA_SHANGHAI|ASIA_SINGAPORE|ASIA_TAIPEI|ASIA_TOKYO|AUSTRALIA_MELBOURNE|AUSTRALIA_SYDNEY|CANADA_CENTRAL|CET|CST6CDT|ETC_GMT|ETC_GMT0|ETC_GMT_ADD_0|ETC_GMT_ADD_1|ETC_GMT_ADD_10|ETC_GMT_ADD_11|ETC_GMT_ADD_12|ETC_GMT_ADD_2|ETC_GMT_ADD_3|ETC_GMT_ADD_4|ETC_GMT_ADD_5|ETC_GMT_ADD_6|ETC_GMT_ADD_7|ETC_GMT_ADD_8|ETC_GMT_ADD_9|ETC_GMT_NEG_0|ETC_GMT_NEG_1|ETC_GMT_NEG_10|ETC_GMT_NEG_11|ETC_GMT_NEG_12|ETC_GMT_NEG_13|ETC_GMT_NEG_14|ETC_GMT_NEG_2|ETC_GMT_NEG_3|ETC_GMT_NEG_4|ETC_GMT_NEG_5|ETC_GMT_NEG_6|ETC_GMT_NEG_7|ETC_GMT_NEG_8|ETC_GMT_NEG_9|EUROPE_DUBLIN|EUROPE_LONDON|EUROPE_PARIS|EUROPE_STOCKHOLM|EUROPE_ZURICH|ISRAEL|MEXICO_GENERAL|MST7MDT|PACIFIC_AUCKLAND|US_CENTRAL|US_EASTERN|US_MOUNTAIN|US_PACIFIC', ], 'type' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assetFormsInput
-
- Type: Array of FormInput structures
The metadata forms that are to be attached to the assets that this data source works with.
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- configuration
-
- Type: DataSourceConfigurationInput structure
Specifies the configuration of the data source. It can be set to either
glueRunConfiguration
orredshiftRunConfiguration
. - connectionIdentifier
-
- Type: string
The ID of the connection.
- description
-
- Type: string
The description of the data source.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where the data source is created.
- enableSetting
-
- Type: string
Specifies whether the data source is enabled.
- environmentIdentifier
-
- Type: string
The unique identifier of the Amazon DataZone environment to which the data source publishes assets.
- name
-
- Required: Yes
- Type: string
The name of the data source.
- projectIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone project in which you want to add this data source.
- publishOnImport
-
- Type: boolean
Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.
- recommendation
-
- Type: RecommendationConfiguration structure
Specifies whether the business name generation is to be enabled for this data source.
- schedule
-
- Type: ScheduleConfiguration structure
The schedule of the data source runs.
- type
-
- Required: Yes
- Type: string
The type of the data source.
Result Syntax
[ 'assetFormsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'configuration' => [ 'glueRunConfiguration' => [ 'accountId' => '<string>', 'autoImportDataQualityResult' => true || false, 'catalogName' => '<string>', 'dataAccessRole' => '<string>', 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'redshiftRunConfiguration' => [ 'accountId' => '<string>', 'dataAccessRole' => '<string>', 'redshiftCredentialConfiguration' => [ 'secretManagerArn' => '<string>', ], 'redshiftStorage' => [ 'redshiftClusterSource' => [ 'clusterName' => '<string>', ], 'redshiftServerlessSource' => [ 'workgroupName' => '<string>', ], ], 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'sageMakerRunConfiguration' => [ 'accountId' => '<string>', 'region' => '<string>', 'trackingAssets' => [ '<SageMakerAssetType>' => ['<string>', ...], // ... ], ], ], 'connectionId' => '<string>', 'createdAt' => <DateTime>, 'description' => '<string>', 'domainId' => '<string>', 'enableSetting' => 'ENABLED|DISABLED', 'environmentId' => '<string>', 'errorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'id' => '<string>', 'lastRunAt' => <DateTime>, 'lastRunErrorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'lastRunStatus' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS', 'name' => '<string>', 'projectId' => '<string>', 'publishOnImport' => true || false, 'recommendation' => [ 'enableBusinessNameGeneration' => true || false, ], 'schedule' => [ 'schedule' => '<string>', 'timezone' => 'UTC|AFRICA_JOHANNESBURG|AMERICA_MONTREAL|AMERICA_SAO_PAULO|ASIA_BAHRAIN|ASIA_BANGKOK|ASIA_CALCUTTA|ASIA_DUBAI|ASIA_HONG_KONG|ASIA_JAKARTA|ASIA_KUALA_LUMPUR|ASIA_SEOUL|ASIA_SHANGHAI|ASIA_SINGAPORE|ASIA_TAIPEI|ASIA_TOKYO|AUSTRALIA_MELBOURNE|AUSTRALIA_SYDNEY|CANADA_CENTRAL|CET|CST6CDT|ETC_GMT|ETC_GMT0|ETC_GMT_ADD_0|ETC_GMT_ADD_1|ETC_GMT_ADD_10|ETC_GMT_ADD_11|ETC_GMT_ADD_12|ETC_GMT_ADD_2|ETC_GMT_ADD_3|ETC_GMT_ADD_4|ETC_GMT_ADD_5|ETC_GMT_ADD_6|ETC_GMT_ADD_7|ETC_GMT_ADD_8|ETC_GMT_ADD_9|ETC_GMT_NEG_0|ETC_GMT_NEG_1|ETC_GMT_NEG_10|ETC_GMT_NEG_11|ETC_GMT_NEG_12|ETC_GMT_NEG_13|ETC_GMT_NEG_14|ETC_GMT_NEG_2|ETC_GMT_NEG_3|ETC_GMT_NEG_4|ETC_GMT_NEG_5|ETC_GMT_NEG_6|ETC_GMT_NEG_7|ETC_GMT_NEG_8|ETC_GMT_NEG_9|EUROPE_DUBLIN|EUROPE_LONDON|EUROPE_PARIS|EUROPE_STOCKHOLM|EUROPE_ZURICH|ISRAEL|MEXICO_GENERAL|MST7MDT|PACIFIC_AUCKLAND|US_CENTRAL|US_EASTERN|US_MOUNTAIN|US_PACIFIC', ], 'status' => 'CREATING|FAILED_CREATION|READY|UPDATING|FAILED_UPDATE|RUNNING|DELETING|FAILED_DELETION', 'type' => '<string>', 'updatedAt' => <DateTime>, ]
Result Details
Members
- assetFormsOutput
-
- Type: Array of FormOutput structures
The metadata forms attached to the assets that this data source creates.
- configuration
-
- Type: DataSourceConfigurationOutput structure
Specifies the configuration of the data source. It can be set to either
glueRunConfiguration
orredshiftRunConfiguration
. - connectionId
-
- Type: string
The ID of the connection.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was created.
- description
-
- Type: string
The description of the data source.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data source is created.
- enableSetting
-
- Type: string
Specifies whether the data source is enabled.
- environmentId
-
- Type: string
The unique identifier of the Amazon DataZone environment to which the data source publishes assets.
- errorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The unique identifier of the data source.
- lastRunAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp that specifies when the data source was last run.
- lastRunErrorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- lastRunStatus
-
- Type: string
The status of the last run of this data source.
- name
-
- Required: Yes
- Type: string
The name of the data source.
- projectId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone project to which the data source is added.
- publishOnImport
-
- Type: boolean
Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.
- recommendation
-
- Type: RecommendationConfiguration structure
Specifies whether the business name generation is to be enabled for this data source.
- schedule
-
- Type: ScheduleConfiguration structure
The schedule of the data source runs.
- status
-
- Type: string
The status of the data source.
- type
-
- Type: string
The type of the data source.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateDomain
$result = $client->createDomain
([/* ... */]); $promise = $client->createDomainAsync
([/* ... */]);
Creates an Amazon DataZone domain.
Parameter Syntax
$result = $client->createDomain([ 'clientToken' => '<string>', 'description' => '<string>', 'domainExecutionRole' => '<string>', // REQUIRED 'domainVersion' => 'V1|V2', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', // REQUIRED 'serviceRole' => '<string>', 'singleSignOn' => [ 'type' => 'IAM_IDC|DISABLED', 'userAssignment' => 'AUTOMATIC|MANUAL', ], 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
The description of the Amazon DataZone domain.
- domainExecutionRole
-
- Required: Yes
- Type: string
The domain execution role that is created when an Amazon DataZone domain is created. The domain execution role is created in the Amazon Web Services account that houses the Amazon DataZone domain.
- domainVersion
-
- Type: string
The version of the domain that is created.
- kmsKeyIdentifier
-
- Type: string
The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.
- name
-
- Required: Yes
- Type: string
The name of the Amazon DataZone domain.
- serviceRole
-
- Type: string
The service role of the domain that is created.
- singleSignOn
-
- Type: SingleSignOn structure
The single-sign on configuration of the Amazon DataZone domain.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags specified for the Amazon DataZone domain.
Result Syntax
[ 'arn' => '<string>', 'description' => '<string>', 'domainExecutionRole' => '<string>', 'domainVersion' => 'V1|V2', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'name' => '<string>', 'portalUrl' => '<string>', 'rootDomainUnitId' => '<string>', 'serviceRole' => '<string>', 'singleSignOn' => [ 'type' => 'IAM_IDC|DISABLED', 'userAssignment' => 'AUTOMATIC|MANUAL', ], 'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The ARN of the Amazon DataZone domain.
- description
-
- Type: string
The description of the Amazon DataZone domain.
- domainExecutionRole
-
- Type: string
The domain execution role that is created when an Amazon DataZone domain is created. The domain execution role is created in the Amazon Web Services account that houses the Amazon DataZone domain.
- domainVersion
-
- Type: string
The version of the domain that is created.
- id
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- kmsKeyIdentifier
-
- Type: string
The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.
- name
-
- Type: string
The name of the Amazon DataZone domain.
- portalUrl
-
- Type: string
The URL of the data portal for this Amazon DataZone domain.
- rootDomainUnitId
-
- Type: string
The ID of the root domain unit.
- serviceRole
-
- Type: string
Te service role of the domain that is created.
- singleSignOn
-
- Type: SingleSignOn structure
The single-sign on configuration of the Amazon DataZone domain.
- status
-
- Type: string
The status of the Amazon DataZone domain.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags specified for the Amazon DataZone domain.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateDomainUnit
$result = $client->createDomainUnit
([/* ... */]); $promise = $client->createDomainUnitAsync
([/* ... */]);
Creates a domain unit in Amazon DataZone.
Parameter Syntax
$result = $client->createDomainUnit([ 'clientToken' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'parentDomainUnitIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
The description of the domain unit.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to crate a domain unit.
- name
-
- Required: Yes
- Type: string
The name of the domain unit.
- parentDomainUnitIdentifier
-
- Required: Yes
- Type: string
The ID of the parent domain unit.
Result Syntax
[ 'ancestorDomainUnitIds' => ['<string>', ...], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'owners' => [ [ 'group' => [ 'groupId' => '<string>', ], 'user' => [ 'userId' => '<string>', ], ], // ... ], 'parentDomainUnitId' => '<string>', ]
Result Details
Members
- ancestorDomainUnitIds
-
- Required: Yes
- Type: Array of strings
The IDs of the ancestor domain units.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the domain unit was created.
- createdBy
-
- Type: string
The user who created the domain unit.
- description
-
- Type: string
The description of the domain unit.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where the domain unit was created.
- id
-
- Required: Yes
- Type: string
The ID of the domain unit.
- name
-
- Required: Yes
- Type: string
The name of the domain unit.
- owners
-
- Required: Yes
- Type: Array of DomainUnitOwnerProperties structures
The owners of the domain unit.
- parentDomainUnitId
-
- Type: string
The ID of the parent domain unit.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateEnvironment
$result = $client->createEnvironment
([/* ... */]); $promise = $client->createEnvironmentAsync
([/* ... */]);
Create an Amazon DataZone environment.
Parameter Syntax
$result = $client->createEnvironment([ 'deploymentOrder' => <integer>, 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentAccountIdentifier' => '<string>', 'environmentAccountRegion' => '<string>', 'environmentBlueprintIdentifier' => '<string>', 'environmentConfigurationId' => '<string>', 'environmentProfileIdentifier' => '<string>', // REQUIRED 'glossaryTerms' => ['<string>', ...], 'name' => '<string>', // REQUIRED 'projectIdentifier' => '<string>', // REQUIRED 'userParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ]);
Parameter Details
Members
- deploymentOrder
-
- Type: int
The deployment order of the environment.
- description
-
- Type: string
The description of the Amazon DataZone environment.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the environment is created.
- environmentAccountIdentifier
-
- Type: string
The ID of the account in which the environment is being created.
- environmentAccountRegion
-
- Type: string
The region of the account in which the environment is being created.
- environmentBlueprintIdentifier
-
- Type: string
The ID of the blueprint with which the environment is being created.
- environmentConfigurationId
-
- Type: string
The configuration ID of the environment.
- environmentProfileIdentifier
-
- Required: Yes
- Type: string
The identifier of the environment profile that is used to create this Amazon DataZone environment.
- glossaryTerms
-
- Type: Array of strings
The glossary terms that can be used in this Amazon DataZone environment.
- name
-
- Required: Yes
- Type: string
The name of the Amazon DataZone environment.
- projectIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone project in which this environment is created.
- userParameters
-
- Type: Array of EnvironmentParameter structures
The user parameters of this Amazon DataZone environment.
Result Syntax
[ 'awsAccountId' => '<string>', 'awsAccountRegion' => '<string>', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'deploymentProperties' => [ 'endTimeoutMinutes' => <integer>, 'startTimeoutMinutes' => <integer>, ], 'description' => '<string>', 'domainId' => '<string>', 'environmentActions' => [ [ 'auth' => 'IAM|HTTPS', 'parameters' => [ [ 'key' => '<string>', 'value' => '<string>', ], // ... ], 'type' => '<string>', ], // ... ], 'environmentBlueprintId' => '<string>', 'environmentProfileId' => '<string>', 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'lastDeployment' => [ 'deploymentId' => '<string>', 'deploymentStatus' => 'IN_PROGRESS|SUCCESSFUL|FAILED|PENDING_DEPLOYMENT', 'deploymentType' => 'CREATE|UPDATE|DELETE', 'failureReason' => [ 'code' => '<string>', 'message' => '<string>', ], 'isDeploymentComplete' => true || false, 'messages' => ['<string>', ...], ], 'name' => '<string>', 'projectId' => '<string>', 'provider' => '<string>', 'provisionedResources' => [ [ 'name' => '<string>', 'provider' => '<string>', 'type' => '<string>', 'value' => '<string>', ], // ... ], 'provisioningProperties' => [ 'cloudFormation' => [ 'templateUrl' => '<string>', ], ], 'status' => 'ACTIVE|CREATING|UPDATING|DELETING|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED|VALIDATION_FAILED|SUSPENDED|DISABLED|EXPIRED|DELETED|INACCESSIBLE', 'updatedAt' => <DateTime>, 'userParameters' => [ [ 'defaultValue' => '<string>', 'description' => '<string>', 'fieldType' => '<string>', 'isEditable' => true || false, 'isOptional' => true || false, 'keyName' => '<string>', ], // ... ], ]
Result Details
Members
- awsAccountId
-
- Type: string
The Amazon Web Services account in which the Amazon DataZone environment is created.
- awsAccountRegion
-
- Type: string
The Amazon Web Services region in which the Amazon DataZone environment is created.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created this environment.
- deploymentProperties
-
- Type: DeploymentProperties structure
The deployment properties of this Amazon DataZone environment.
- description
-
- Type: string
The description of this Amazon DataZone environment.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the environment is created.
- environmentActions
-
- Type: Array of ConfigurableEnvironmentAction structures
The configurable actions of this Amazon DataZone environment.
- environmentBlueprintId
-
- Type: string
The ID of the blueprint with which this Amazon DataZone environment was created.
- environmentProfileId
-
- Type: string
The ID of the environment profile with which this Amazon DataZone environment was created.
- glossaryTerms
-
- Type: Array of strings
The glossary terms that can be used in this Amazon DataZone environment.
- id
-
- Type: string
The ID of this Amazon DataZone environment.
- lastDeployment
-
- Type: Deployment structure
The details of the last deployment of this Amazon DataZone environment.
- name
-
- Required: Yes
- Type: string
The name of this environment.
- projectId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone project in which this environment is created.
- provider
-
- Required: Yes
- Type: string
The provider of this Amazon DataZone environment.
- provisionedResources
-
- Type: Array of Resource structures
The provisioned resources of this Amazon DataZone environment.
- provisioningProperties
-
- Type: ProvisioningProperties structure
The provisioning properties of this Amazon DataZone environment.
- status
-
- Type: string
The status of this Amazon DataZone environment.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this environment was updated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters of this Amazon DataZone environment.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateEnvironmentAction
$result = $client->createEnvironmentAction
([/* ... */]); $promise = $client->createEnvironmentActionAsync
([/* ... */]);
Creates an action for the environment, for example, creates a console link for an analytics tool that is available in this environment.
Parameter Syntax
$result = $client->createEnvironmentAction([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'parameters' => [ // REQUIRED 'awsConsoleLink' => [ 'uri' => '<string>', ], ], ]);
Parameter Details
Members
- description
-
- Type: string
The description of the environment action that is being created in the environment.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the environment action is created.
- environmentIdentifier
-
- Required: Yes
- Type: string
The ID of the environment in which the environment action is created.
- name
-
- Required: Yes
- Type: string
The name of the environment action.
- parameters
-
- Required: Yes
- Type: ActionParameters structure
The parameters of the environment action.
Result Syntax
[ 'description' => '<string>', 'domainId' => '<string>', 'environmentId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'parameters' => [ 'awsConsoleLink' => [ 'uri' => '<string>', ], ], ]
Result Details
Members
- description
-
- Type: string
The description of the environment action.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain in which the environment action is created.
- environmentId
-
- Required: Yes
- Type: string
The ID of the environment in which the environment is created.
- id
-
- Required: Yes
- Type: string
The ID of the environment action.
- name
-
- Required: Yes
- Type: string
The name of the environment action.
- parameters
-
- Required: Yes
- Type: ActionParameters structure
The parameters of the environment action.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateEnvironmentProfile
$result = $client->createEnvironmentProfile
([/* ... */]); $promise = $client->createEnvironmentProfileAsync
([/* ... */]);
Creates an Amazon DataZone environment profile.
Parameter Syntax
$result = $client->createEnvironmentProfile([ 'awsAccountId' => '<string>', 'awsAccountRegion' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentBlueprintIdentifier' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'projectIdentifier' => '<string>', // REQUIRED 'userParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ]);
Parameter Details
Members
- awsAccountId
-
- Type: string
The Amazon Web Services account in which the Amazon DataZone environment is created.
- awsAccountRegion
-
- Type: string
The Amazon Web Services region in which this environment profile is created.
- description
-
- Type: string
The description of this Amazon DataZone environment profile.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this environment profile is created.
- environmentBlueprintIdentifier
-
- Required: Yes
- Type: string
The ID of the blueprint with which this environment profile is created.
- name
-
- Required: Yes
- Type: string
The name of this Amazon DataZone environment profile.
- projectIdentifier
-
- Required: Yes
- Type: string
The identifier of the project in which to create the environment profile.
- userParameters
-
- Type: Array of EnvironmentParameter structures
The user parameters of this Amazon DataZone environment profile.
Result Syntax
[ 'awsAccountId' => '<string>', 'awsAccountRegion' => '<string>', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'environmentBlueprintId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'projectId' => '<string>', 'updatedAt' => <DateTime>, 'userParameters' => [ [ 'defaultValue' => '<string>', 'description' => '<string>', 'fieldType' => '<string>', 'isEditable' => true || false, 'isOptional' => true || false, 'keyName' => '<string>', ], // ... ], ]
Result Details
Members
- awsAccountId
-
- Type: string
The Amazon Web Services account ID in which this Amazon DataZone environment profile is created.
- awsAccountRegion
-
- Type: string
The Amazon Web Services region in which this Amazon DataZone environment profile is created.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this environment profile was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created this environment profile.
- description
-
- Type: string
The description of this Amazon DataZone environment profile.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this environment profile is created.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The ID of the blueprint with which this environment profile is created.
- id
-
- Required: Yes
- Type: string
The ID of this Amazon DataZone environment profile.
- name
-
- Required: Yes
- Type: string
The name of this Amazon DataZone environment profile.
- projectId
-
- Type: string
The ID of the Amazon DataZone project in which this environment profile is created.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this environment profile was updated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters of this Amazon DataZone environment profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateFormType
$result = $client->createFormType
([/* ... */]); $promise = $client->createFormTypeAsync
([/* ... */]);
Creates a metadata form type.
Parameter Syntax
$result = $client->createFormType([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'model' => [ // REQUIRED 'smithy' => '<string>', ], 'name' => '<string>', // REQUIRED 'owningProjectIdentifier' => '<string>', // REQUIRED 'status' => 'ENABLED|DISABLED', ]);
Parameter Details
Members
- description
-
- Type: string
The description of this Amazon DataZone metadata form type.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this metadata form type is created.
- model
-
- Required: Yes
- Type: Model structure
The model of this Amazon DataZone metadata form type.
- name
-
- Required: Yes
- Type: string
The name of this Amazon DataZone metadata form type.
- owningProjectIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone project that owns this metadata form type.
- status
-
- Type: string
The status of this Amazon DataZone metadata form type.
Result Syntax
[ 'description' => '<string>', 'domainId' => '<string>', 'name' => '<string>', 'originDomainId' => '<string>', 'originProjectId' => '<string>', 'owningProjectId' => '<string>', 'revision' => '<string>', ]
Result Details
Members
- description
-
- Type: string
The description of this Amazon DataZone metadata form type.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this metadata form type is created.
- name
-
- Required: Yes
- Type: string
The name of this Amazon DataZone metadata form type.
- originDomainId
-
- Type: string
The ID of the Amazon DataZone domain in which this metadata form type was originally created.
- originProjectId
-
- Type: string
The ID of the project in which this Amazon DataZone metadata form type was originally created.
- owningProjectId
-
- Type: string
The ID of the project that owns this Amazon DataZone metadata form type.
- revision
-
- Required: Yes
- Type: string
The revision of this Amazon DataZone metadata form type.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateGlossary
$result = $client->createGlossary
([/* ... */]); $promise = $client->createGlossaryAsync
([/* ... */]);
Creates an Amazon DataZone business glossary.
Parameter Syntax
$result = $client->createGlossary([ 'clientToken' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'owningProjectIdentifier' => '<string>', // REQUIRED 'status' => 'DISABLED|ENABLED', ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
The description of this business glossary.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary is created.
- name
-
- Required: Yes
- Type: string
The name of this business glossary.
- owningProjectIdentifier
-
- Required: Yes
- Type: string
The ID of the project that currently owns business glossary.
- status
-
- Type: string
The status of this business glossary.
Result Syntax
[ 'description' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', 'status' => 'DISABLED|ENABLED', ]
Result Details
Members
- description
-
- Type: string
The description of this business glossary.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary is created.
- id
-
- Required: Yes
- Type: string
The ID of this business glossary.
- name
-
- Required: Yes
- Type: string
The name of this business glossary.
- owningProjectId
-
- Required: Yes
- Type: string
The ID of the project that currently owns this business glossary.
- status
-
- Type: string
The status of this business glossary.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateGlossaryTerm
$result = $client->createGlossaryTerm
([/* ... */]); $promise = $client->createGlossaryTermAsync
([/* ... */]);
Creates a business glossary term.
Parameter Syntax
$result = $client->createGlossaryTerm([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'glossaryIdentifier' => '<string>', // REQUIRED 'longDescription' => '<string>', 'name' => '<string>', // REQUIRED 'shortDescription' => '<string>', 'status' => 'ENABLED|DISABLED', 'termRelations' => [ 'classifies' => ['<string>', ...], 'isA' => ['<string>', ...], ], ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary term is created.
- glossaryIdentifier
-
- Required: Yes
- Type: string
The ID of the business glossary in which this term is created.
- longDescription
-
- Type: string
The long description of this business glossary term.
- name
-
- Required: Yes
- Type: string
The name of this business glossary term.
- shortDescription
-
- Type: string
The short description of this business glossary term.
- status
-
- Type: string
The status of this business glossary term.
- termRelations
-
- Type: TermRelations structure
The term relations of this business glossary term.
Result Syntax
[ 'domainId' => '<string>', 'glossaryId' => '<string>', 'id' => '<string>', 'longDescription' => '<string>', 'name' => '<string>', 'shortDescription' => '<string>', 'status' => 'ENABLED|DISABLED', 'termRelations' => [ 'classifies' => ['<string>', ...], 'isA' => ['<string>', ...], ], ]
Result Details
Members
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary term is created.
- glossaryId
-
- Required: Yes
- Type: string
The ID of the business glossary in which this term is created.
- id
-
- Required: Yes
- Type: string
The ID of this business glossary term.
- longDescription
-
- Type: string
The long description of this business glossary term.
- name
-
- Required: Yes
- Type: string
The name of this business glossary term.
- shortDescription
-
- Type: string
The short description of this business glossary term.
- status
-
- Required: Yes
- Type: string
The status of this business glossary term.
- termRelations
-
- Type: TermRelations structure
The term relations of this business glossary term.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateGroupProfile
$result = $client->createGroupProfile
([/* ... */]); $promise = $client->createGroupProfileAsync
([/* ... */]);
Creates a group profile in Amazon DataZone.
Parameter Syntax
$result = $client->createGroupProfile([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'groupIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the group profile is created.
- groupIdentifier
-
- Required: Yes
- Type: string
The identifier of the group for which the group profile is created.
Result Syntax
[ 'domainId' => '<string>', 'groupName' => '<string>', 'id' => '<string>', 'status' => 'ASSIGNED|NOT_ASSIGNED', ]
Result Details
Members
- domainId
-
- Type: string
The identifier of the Amazon DataZone domain in which the group profile is created.
- groupName
-
- Type: string
The name of the group for which group profile is created.
- id
-
- Type: string
The identifier of the group profile.
- status
-
- Type: string
The status of the group profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateListingChangeSet
$result = $client->createListingChangeSet
([/* ... */]); $promise = $client->createListingChangeSetAsync
([/* ... */]);
Publishes a listing (a record of an asset at a given time) or removes a listing from the catalog.
Parameter Syntax
$result = $client->createListingChangeSet([ 'action' => 'PUBLISH|UNPUBLISH', // REQUIRED 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'entityIdentifier' => '<string>', // REQUIRED 'entityRevision' => '<string>', 'entityType' => 'ASSET|DATA_PRODUCT', // REQUIRED ]);
Parameter Details
Members
- action
-
- Required: Yes
- Type: string
Specifies whether to publish or unpublish a listing.
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the asset.
- entityRevision
-
- Type: string
The revision of an asset.
- entityType
-
- Required: Yes
- Type: string
The type of an entity.
Result Syntax
[ 'listingId' => '<string>', 'listingRevision' => '<string>', 'status' => 'CREATING|ACTIVE|INACTIVE', ]
Result Details
Members
- listingId
-
- Required: Yes
- Type: string
The ID of the listing (a record of an asset at a given time).
- listingRevision
-
- Required: Yes
- Type: string
The revision of a listing.
- status
-
- Required: Yes
- Type: string
Specifies the status of the listing.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateProject
$result = $client->createProject
([/* ... */]); $promise = $client->createProjectAsync
([/* ... */]);
Creates an Amazon DataZone project.
Parameter Syntax
$result = $client->createProject([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'domainUnitId' => '<string>', 'glossaryTerms' => ['<string>', ...], 'name' => '<string>', // REQUIRED 'projectProfileId' => '<string>', 'userParameters' => [ [ 'environmentConfigurationName' => '<string>', 'environmentParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ], // ... ], ]);
Parameter Details
Members
- description
-
- Type: string
The description of the Amazon DataZone project.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this project is created.
- domainUnitId
-
- Type: string
The ID of the domain unit. This parameter is not required and if it is not specified, then the project is created at the root domain unit level.
- glossaryTerms
-
- Type: Array of strings
The glossary terms that can be used in this Amazon DataZone project.
- name
-
- Required: Yes
- Type: string
The name of the Amazon DataZone project.
- projectProfileId
-
- Type: string
The ID of the project profile.
- userParameters
-
- Type: Array of EnvironmentConfigurationUserParameter structures
The user parameters of the project.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentDeploymentDetails' => [ 'environmentFailureReasons' => [ '<String>' => [ [ 'code' => '<string>', 'message' => '<string>', ], // ... ], // ... ], 'overallDeploymentStatus' => 'PENDING_DEPLOYMENT|IN_PROGRESS|SUCCESSFUL|FAILED_VALIDATION|FAILED_DEPLOYMENT', ], 'failureReasons' => [ [ 'code' => '<string>', 'message' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'projectProfileId' => '<string>', 'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED', 'userParameters' => [ [ 'environmentConfigurationName' => '<string>', 'environmentParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ], // ... ], ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the project.
- description
-
- Type: string
The description of the project.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the project was created.
- domainUnitId
-
- Type: string
The ID of the domain unit.
- environmentDeploymentDetails
-
- Type: EnvironmentDeploymentDetails structure
The environment deployment details.
- failureReasons
-
- Type: Array of ProjectDeletionError structures
Specifies the error message that is returned if the operation cannot be successfully completed.
- glossaryTerms
-
- Type: Array of strings
The glossary terms that can be used in the project.
- id
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone project.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project was last updated.
- name
-
- Required: Yes
- Type: string
The name of the project.
- projectProfileId
-
- Type: string
The project profile ID.
- projectStatus
-
- Type: string
The status of the Amazon DataZone project that was created.
- userParameters
-
- Type: Array of EnvironmentConfigurationUserParameter structures
The user parameters of the project.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateProjectMembership
$result = $client->createProjectMembership
([/* ... */]); $promise = $client->createProjectMembershipAsync
([/* ... */]);
Creates a project membership in Amazon DataZone.
Parameter Syntax
$result = $client->createProjectMembership([ 'designation' => 'PROJECT_OWNER|PROJECT_CONTRIBUTOR|PROJECT_CATALOG_VIEWER|PROJECT_CATALOG_CONSUMER|PROJECT_CATALOG_STEWARD', // REQUIRED 'domainIdentifier' => '<string>', // REQUIRED 'member' => [ // REQUIRED 'groupIdentifier' => '<string>', 'userIdentifier' => '<string>', ], 'projectIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- designation
-
- Required: Yes
- Type: string
The designation of the project membership.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which project membership is created.
- member
-
- Required: Yes
- Type: Member structure
The project member whose project membership was created.
- projectIdentifier
-
- Required: Yes
- Type: string
The ID of the project for which this project membership was created.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateProjectProfile
$result = $client->createProjectProfile
([/* ... */]); $promise = $client->createProjectProfileAsync
([/* ... */]);
Creates a project profile.
Parameter Syntax
$result = $client->createProjectProfile([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'domainUnitIdentifier' => '<string>', 'environmentConfigurations' => [ [ 'awsAccount' => [ // REQUIRED 'awsAccountId' => '<string>', 'awsAccountIdPath' => '<string>', ], 'awsRegion' => [ // REQUIRED 'regionName' => '<string>', 'regionNamePath' => '<string>', ], 'configurationParameters' => [ 'parameterOverrides' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'resolvedParameters' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'ssmPath' => '<string>', ], 'deploymentMode' => 'ON_CREATE|ON_DEMAND', 'deploymentOrder' => <integer>, 'description' => '<string>', 'environmentBlueprintId' => '<string>', // REQUIRED 'id' => '<string>', 'name' => '<string>', // REQUIRED ], // ... ], 'name' => '<string>', // REQUIRED 'status' => 'ENABLED|DISABLED', ]);
Parameter Details
Members
- description
-
- Type: string
A description of a project profile.
- domainIdentifier
-
- Required: Yes
- Type: string
A domain ID of the project profile.
- domainUnitIdentifier
-
- Type: string
A domain unit ID of the project profile.
- environmentConfigurations
-
- Type: Array of EnvironmentConfiguration structures
Environment configurations of the project profile.
- name
-
- Required: Yes
- Type: string
Project profile name.
- status
-
- Type: string
Project profile status.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentConfigurations' => [ [ 'awsAccount' => [ 'awsAccountId' => '<string>', 'awsAccountIdPath' => '<string>', ], 'awsRegion' => [ 'regionName' => '<string>', 'regionNamePath' => '<string>', ], 'configurationParameters' => [ 'parameterOverrides' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'resolvedParameters' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'ssmPath' => '<string>', ], 'deploymentMode' => 'ON_CREATE|ON_DEMAND', 'deploymentOrder' => <integer>, 'description' => '<string>', 'environmentBlueprintId' => '<string>', 'id' => '<string>', 'name' => '<string>', ], // ... ], 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'status' => 'ENABLED|DISABLED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp at which a project profile is created.
- createdBy
-
- Required: Yes
- Type: string
A user who created a project profile.
- description
-
- Type: string
A project profile description.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where a project profile is created.
- domainUnitId
-
- Type: string
The ID of the domain unit where a project profile is created.
- environmentConfigurations
-
- Type: Array of EnvironmentConfiguration structures
Environment configurations of a project profile.
- id
-
- Required: Yes
- Type: string
Project profile ID.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp when a project profile was last updated.
- name
-
- Required: Yes
- Type: string
Project profile name.
- status
-
- Type: string
Project profile status.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateRule
$result = $client->createRule
([/* ... */]); $promise = $client->createRuleAsync
([/* ... */]);
Creates a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.
Parameter Syntax
$result = $client->createRule([ 'action' => 'CREATE_SUBSCRIPTION_REQUEST', // REQUIRED 'clientToken' => '<string>', 'description' => '<string>', 'detail' => [ // REQUIRED 'metadataFormEnforcementDetail' => [ 'requiredMetadataForms' => [ [ 'typeIdentifier' => '<string>', // REQUIRED 'typeRevision' => '<string>', // REQUIRED ], // ... ], ], ], 'domainIdentifier' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'scope' => [ // REQUIRED 'assetType' => [ 'selectionMode' => 'ALL|SPECIFIC', // REQUIRED 'specificAssetTypes' => ['<string>', ...], ], 'dataProduct' => true || false, 'project' => [ 'selectionMode' => 'ALL|SPECIFIC', // REQUIRED 'specificProjects' => ['<string>', ...], ], ], 'target' => [ // REQUIRED 'domainUnitTarget' => [ 'domainUnitId' => '<string>', // REQUIRED 'includeChildDomainUnits' => true || false, ], ], ]);
Parameter Details
Members
- action
-
- Required: Yes
- Type: string
The action of the rule.
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- description
-
- Type: string
The description of the rule.
- detail
-
- Required: Yes
- Type: RuleDetail structure
The detail of the rule.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the rule is created.
- name
-
- Required: Yes
- Type: string
The name of the rule.
- scope
-
- Required: Yes
- Type: RuleScope structure
The scope of the rule.
- target
-
- Required: Yes
- Type: RuleTarget structure
The target of the rule.
Result Syntax
[ 'action' => 'CREATE_SUBSCRIPTION_REQUEST', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'detail' => [ 'metadataFormEnforcementDetail' => [ 'requiredMetadataForms' => [ [ 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], ], ], 'identifier' => '<string>', 'name' => '<string>', 'ruleType' => 'METADATA_FORM_ENFORCEMENT', 'scope' => [ 'assetType' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificAssetTypes' => ['<string>', ...], ], 'dataProduct' => true || false, 'project' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificProjects' => ['<string>', ...], ], ], 'target' => [ 'domainUnitTarget' => [ 'domainUnitId' => '<string>', 'includeChildDomainUnits' => true || false, ], ], 'targetType' => 'DOMAIN_UNIT', ]
Result Details
Members
- action
-
- Required: Yes
- Type: string
The action of the rule.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the rule is created.
- createdBy
-
- Required: Yes
- Type: string
The user who creates the rule.
- description
-
- Type: string
The description of the rule.
- detail
-
- Required: Yes
- Type: RuleDetail structure
The detail of the rule.
- identifier
-
- Required: Yes
- Type: string
The ID of the rule.
- name
-
- Required: Yes
- Type: string
The name of the rule.
- ruleType
-
- Required: Yes
- Type: string
The type of the rule.
- scope
-
- Required: Yes
- Type: RuleScope structure
The scope of the rule.
- target
-
- Required: Yes
- Type: RuleTarget structure
The target of the rule.
- targetType
-
- Type: string
The target type of the rule.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateSubscriptionGrant
$result = $client->createSubscriptionGrant
([/* ... */]); $promise = $client->createSubscriptionGrantAsync
([/* ... */]);
Creates a subsscription grant in Amazon DataZone.
Parameter Syntax
$result = $client->createSubscriptionGrant([ 'assetTargetNames' => [ [ 'assetId' => '<string>', // REQUIRED 'targetName' => '<string>', // REQUIRED ], // ... ], 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'grantedEntity' => [ // REQUIRED 'listing' => [ 'identifier' => '<string>', // REQUIRED 'revision' => '<string>', // REQUIRED ], ], 'subscriptionTargetIdentifier' => '<string>', ]);
Parameter Details
Members
- assetTargetNames
-
- Type: Array of AssetTargetNameMap structures
The names of the assets for which the subscription grant is created.
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription grant is created.
- environmentIdentifier
-
- Required: Yes
- Type: string
The ID of the environment in which the subscription grant is created.
- grantedEntity
-
- Required: Yes
- Type: GrantedEntityInput structure
The entity to which the subscription is to be granted.
- subscriptionTargetIdentifier
-
- Type: string
The ID of the subscription target for which the subscription grant is created.
Result Syntax
[ 'assets' => [ [ 'assetId' => '<string>', 'assetRevision' => '<string>', 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'failureCause' => [ 'message' => '<string>', ], 'failureTimestamp' => <DateTime>, 'grantedTimestamp' => <DateTime>, 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED', 'targetName' => '<string>', ], // ... ], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'grantedEntity' => [ 'listing' => [ 'id' => '<string>', 'revision' => '<string>', ], ], 'id' => '<string>', 'status' => 'PENDING|IN_PROGRESS|GRANT_FAILED|REVOKE_FAILED|GRANT_AND_REVOKE_FAILED|COMPLETED|INACCESSIBLE', 'subscriptionId' => '<string>', 'subscriptionTargetId' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- assets
-
- Type: Array of SubscribedAsset structures
The assets for which the subscription grant is created.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp of when the subscription grant is created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription grant.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription grant is created.
- grantedEntity
-
- Required: Yes
- Type: GrantedEntity structure
The entity to which the subscription is granted.
- id
-
- Required: Yes
- Type: string
The ID of the subscription grant.
- status
-
- Required: Yes
- Type: string
The status of the subscription grant.
- subscriptionId
-
- Type: string
The identifier of the subscription grant.
- subscriptionTargetId
-
- Required: Yes
- Type: string
The ID of the subscription target for which the subscription grant is created.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp of when the subscription grant was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription grant.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateSubscriptionRequest
$result = $client->createSubscriptionRequest
([/* ... */]); $promise = $client->createSubscriptionRequestAsync
([/* ... */]);
Creates a subscription request in Amazon DataZone.
Parameter Syntax
$result = $client->createSubscriptionRequest([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'metadataForms' => [ [ 'content' => '<string>', 'formName' => '<string>', // REQUIRED 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', // REQUIRED 'subscribedListings' => [ // REQUIRED [ 'identifier' => '<string>', // REQUIRED ], // ... ], 'subscribedPrincipals' => [ // REQUIRED [ 'project' => [ 'identifier' => '<string>', ], ], // ... ], ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription request is created.
- metadataForms
-
- Type: Array of FormInput structures
The metadata form included in the subscription request.
- requestReason
-
- Required: Yes
- Type: string
The reason for the subscription request.
- subscribedListings
-
- Required: Yes
- Type: Array of SubscribedListingInput structures
The published asset for which the subscription grant is to be created.
- subscribedPrincipals
-
- Required: Yes
- Type: Array of SubscribedPrincipalInput structures
The Amazon DataZone principals for whom the subscription request is created.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'decisionComment' => '<string>', 'domainId' => '<string>', 'existingSubscriptionId' => '<string>', 'id' => '<string>', 'metadataForms' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', 'reviewerId' => '<string>', 'status' => 'PENDING|ACCEPTED|REJECTED', 'subscribedListings' => [ [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], // ... ], 'subscribedPrincipals' => [ [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], // ... ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp of when the subscription request is created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription request.
- decisionComment
-
- Type: string
The decision comment of the subscription request.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in whcih the subscription request is created.
- existingSubscriptionId
-
- Type: string
The ID of the existing subscription.
- id
-
- Required: Yes
- Type: string
The ID of the subscription request.
- metadataForms
-
- Type: Array of FormOutput structures
The metadata form included in the subscription request.
- requestReason
-
- Required: Yes
- Type: string
The reason for the subscription request.
- reviewerId
-
- Type: string
The ID of the reviewer of the subscription request.
- status
-
- Required: Yes
- Type: string
The status of the subscription request.
- subscribedListings
-
- Required: Yes
- Type: Array of SubscribedListing structures
The published asset for which the subscription grant is to be created.
- subscribedPrincipals
-
- Required: Yes
- Type: Array of SubscribedPrincipal structures
The subscribed principals of the subscription request.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription request was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription request.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateSubscriptionTarget
$result = $client->createSubscriptionTarget
([/* ... */]); $promise = $client->createSubscriptionTargetAsync
([/* ... */]);
Creates a subscription target in Amazon DataZone.
Parameter Syntax
$result = $client->createSubscriptionTarget([ 'applicableAssetTypes' => ['<string>', ...], // REQUIRED 'authorizedPrincipals' => ['<string>', ...], // REQUIRED 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'manageAccessRole' => '<string>', // REQUIRED 'name' => '<string>', // REQUIRED 'provider' => '<string>', 'subscriptionTargetConfig' => [ // REQUIRED [ 'content' => '<string>', // REQUIRED 'formName' => '<string>', // REQUIRED ], // ... ], 'type' => '<string>', // REQUIRED ]);
Parameter Details
Members
- applicableAssetTypes
-
- Required: Yes
- Type: Array of strings
The asset types that can be included in the subscription target.
- authorizedPrincipals
-
- Required: Yes
- Type: Array of strings
The authorized principals of the subscription target.
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which subscription target is created.
- environmentIdentifier
-
- Required: Yes
- Type: string
The ID of the environment in which subscription target is created.
- manageAccessRole
-
- Required: Yes
- Type: string
The manage access role that is used to create the subscription target.
- name
-
- Required: Yes
- Type: string
The name of the subscription target.
- provider
-
- Type: string
The provider of the subscription target.
- subscriptionTargetConfig
-
- Required: Yes
- Type: Array of SubscriptionTargetForm structures
The configuration of the subscription target.
- type
-
- Required: Yes
- Type: string
The type of the subscription target.
Result Syntax
[ 'applicableAssetTypes' => ['<string>', ...], 'authorizedPrincipals' => ['<string>', ...], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'environmentId' => '<string>', 'id' => '<string>', 'manageAccessRole' => '<string>', 'name' => '<string>', 'projectId' => '<string>', 'provider' => '<string>', 'subscriptionTargetConfig' => [ [ 'content' => '<string>', 'formName' => '<string>', ], // ... ], 'type' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- applicableAssetTypes
-
- Required: Yes
- Type: Array of strings
The asset types that can be included in the subscription target.
- authorizedPrincipals
-
- Required: Yes
- Type: Array of strings
The authorised principals of the subscription target.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription target was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription target.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription target was created.
- environmentId
-
- Required: Yes
- Type: string
The ID of the environment in which the subscription target was created.
- id
-
- Required: Yes
- Type: string
The ID of the subscription target.
- manageAccessRole
-
- Type: string
The manage access role with which the subscription target was created.
- name
-
- Required: Yes
- Type: string
The name of the subscription target.
- projectId
-
- Required: Yes
- Type: string
???
- provider
-
- Required: Yes
- Type: string
The provider of the subscription target.
- subscriptionTargetConfig
-
- Required: Yes
- Type: Array of SubscriptionTargetForm structures
The configuration of the subscription target.
- type
-
- Required: Yes
- Type: string
The type of the subscription target.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription target was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription target.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
CreateUserProfile
$result = $client->createUserProfile
([/* ... */]); $promise = $client->createUserProfileAsync
([/* ... */]);
Creates a user profile in Amazon DataZone.
Parameter Syntax
$result = $client->createUserProfile([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'userIdentifier' => '<string>', // REQUIRED 'userType' => 'IAM_USER|IAM_ROLE|SSO_USER', ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a user profile is created.
- userIdentifier
-
- Required: Yes
- Type: string
The identifier of the user for which the user profile is created.
- userType
-
- Type: string
The user type of the user for which the user profile is created.
Result Syntax
[ 'details' => [ 'iam' => [ 'arn' => '<string>', ], 'sso' => [ 'firstName' => '<string>', 'lastName' => '<string>', 'username' => '<string>', ], ], 'domainId' => '<string>', 'id' => '<string>', 'status' => 'ASSIGNED|NOT_ASSIGNED|ACTIVATED|DEACTIVATED', 'type' => 'IAM|SSO', ]
Result Details
Members
- details
-
- Type: UserProfileDetails structure
The details of the user profile in Amazon DataZone.
- domainId
-
- Type: string
The identifier of the Amazon DataZone domain in which a user profile is created.
- id
-
- Type: string
The identifier of the user profile.
- status
-
- Type: string
The status of the user profile.
- type
-
- Type: string
The type of the user profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteAsset
$result = $client->deleteAsset
([/* ... */]); $promise = $client->deleteAssetAsync
([/* ... */]);
Deletes an asset in Amazon DataZone.
Parameter Syntax
$result = $client->deleteAsset([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the asset is deleted.
- identifier
-
- Required: Yes
- Type: string
The identifier of the asset that is deleted.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
DeleteConnection
$result = $client->deleteConnection
([/* ... */]); $promise = $client->deleteConnectionAsync
([/* ... */]);
Deletes and connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.
Parameter Syntax
$result = $client->deleteConnection([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the connection is deleted.
- identifier
-
- Required: Yes
- Type: string
The ID of the connection that is deleted.
Result Syntax
[ 'status' => '<string>', ]
Result Details
Members
- status
-
- Type: string
The status of the action.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteDataProduct
$result = $client->deleteDataProduct
([/* ... */]); $promise = $client->deleteDataProductAsync
([/* ... */]);
Deletes a data product in Amazon DataZone.
Parameter Syntax
$result = $client->deleteDataProduct([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data product is deleted.
- identifier
-
- Required: Yes
- Type: string
The identifier of the data product that is deleted.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteDataSource
$result = $client->deleteDataSource
([/* ... */]); $promise = $client->deleteDataSourceAsync
([/* ... */]);
Deletes a data source in Amazon DataZone.
Parameter Syntax
$result = $client->deleteDataSource([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'retainPermissionsOnRevokeFailure' => true || false, ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data source is deleted.
- identifier
-
- Required: Yes
- Type: string
The identifier of the data source that is deleted.
- retainPermissionsOnRevokeFailure
-
- Type: boolean
Specifies that the granted permissions are retained in case of a self-subscribe functionality failure for a data source.
Result Syntax
[ 'assetFormsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'configuration' => [ 'glueRunConfiguration' => [ 'accountId' => '<string>', 'autoImportDataQualityResult' => true || false, 'catalogName' => '<string>', 'dataAccessRole' => '<string>', 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'redshiftRunConfiguration' => [ 'accountId' => '<string>', 'dataAccessRole' => '<string>', 'redshiftCredentialConfiguration' => [ 'secretManagerArn' => '<string>', ], 'redshiftStorage' => [ 'redshiftClusterSource' => [ 'clusterName' => '<string>', ], 'redshiftServerlessSource' => [ 'workgroupName' => '<string>', ], ], 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'sageMakerRunConfiguration' => [ 'accountId' => '<string>', 'region' => '<string>', 'trackingAssets' => [ '<SageMakerAssetType>' => ['<string>', ...], // ... ], ], ], 'connectionId' => '<string>', 'createdAt' => <DateTime>, 'description' => '<string>', 'domainId' => '<string>', 'enableSetting' => 'ENABLED|DISABLED', 'environmentId' => '<string>', 'errorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'id' => '<string>', 'lastRunAt' => <DateTime>, 'lastRunErrorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'lastRunStatus' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS', 'name' => '<string>', 'projectId' => '<string>', 'publishOnImport' => true || false, 'retainPermissionsOnRevokeFailure' => true || false, 'schedule' => [ 'schedule' => '<string>', 'timezone' => 'UTC|AFRICA_JOHANNESBURG|AMERICA_MONTREAL|AMERICA_SAO_PAULO|ASIA_BAHRAIN|ASIA_BANGKOK|ASIA_CALCUTTA|ASIA_DUBAI|ASIA_HONG_KONG|ASIA_JAKARTA|ASIA_KUALA_LUMPUR|ASIA_SEOUL|ASIA_SHANGHAI|ASIA_SINGAPORE|ASIA_TAIPEI|ASIA_TOKYO|AUSTRALIA_MELBOURNE|AUSTRALIA_SYDNEY|CANADA_CENTRAL|CET|CST6CDT|ETC_GMT|ETC_GMT0|ETC_GMT_ADD_0|ETC_GMT_ADD_1|ETC_GMT_ADD_10|ETC_GMT_ADD_11|ETC_GMT_ADD_12|ETC_GMT_ADD_2|ETC_GMT_ADD_3|ETC_GMT_ADD_4|ETC_GMT_ADD_5|ETC_GMT_ADD_6|ETC_GMT_ADD_7|ETC_GMT_ADD_8|ETC_GMT_ADD_9|ETC_GMT_NEG_0|ETC_GMT_NEG_1|ETC_GMT_NEG_10|ETC_GMT_NEG_11|ETC_GMT_NEG_12|ETC_GMT_NEG_13|ETC_GMT_NEG_14|ETC_GMT_NEG_2|ETC_GMT_NEG_3|ETC_GMT_NEG_4|ETC_GMT_NEG_5|ETC_GMT_NEG_6|ETC_GMT_NEG_7|ETC_GMT_NEG_8|ETC_GMT_NEG_9|EUROPE_DUBLIN|EUROPE_LONDON|EUROPE_PARIS|EUROPE_STOCKHOLM|EUROPE_ZURICH|ISRAEL|MEXICO_GENERAL|MST7MDT|PACIFIC_AUCKLAND|US_CENTRAL|US_EASTERN|US_MOUNTAIN|US_PACIFIC', ], 'selfGrantStatus' => [ 'glueSelfGrantStatus' => [ 'selfGrantStatusDetails' => [ [ 'databaseName' => '<string>', 'failureCause' => '<string>', 'schemaName' => '<string>', 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED', ], // ... ], ], 'redshiftSelfGrantStatus' => [ 'selfGrantStatusDetails' => [ [ 'databaseName' => '<string>', 'failureCause' => '<string>', 'schemaName' => '<string>', 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED', ], // ... ], ], ], 'status' => 'CREATING|FAILED_CREATION|READY|UPDATING|FAILED_UPDATE|RUNNING|DELETING|FAILED_DELETION', 'type' => '<string>', 'updatedAt' => <DateTime>, ]
Result Details
Members
- assetFormsOutput
-
- Type: Array of FormOutput structures
The asset data forms associated with this data source.
- configuration
-
- Type: DataSourceConfigurationOutput structure
The configuration of the data source that is deleted.
- connectionId
-
- Type: string
The ID of the connection that is deleted.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this data source was created.
- description
-
- Type: string
The description of the data source that is deleted.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data source is deleted.
- enableSetting
-
- Type: string
The enable setting of the data source that specifies whether the data source is enabled or disabled.
- environmentId
-
- Type: string
The ID of the environemnt associated with this data source.
- errorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The ID of the data source that is deleted.
- lastRunAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was last run.
- lastRunErrorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- lastRunStatus
-
- Type: string
The status of the last run of this data source.
- name
-
- Required: Yes
- Type: string
The name of the data source that is deleted.
- projectId
-
- Required: Yes
- Type: string
The ID of the project in which this data source exists and from which it's deleted.
- publishOnImport
-
- Type: boolean
Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.
- retainPermissionsOnRevokeFailure
-
- Type: boolean
Specifies that the granted permissions are retained in case of a self-subscribe functionality failure for a data source.
- schedule
-
- Type: ScheduleConfiguration structure
The schedule of runs for this data source.
- selfGrantStatus
-
- Type: SelfGrantStatusOutput structure
Specifies the status of the self-granting functionality.
- status
-
- Type: string
The status of this data source.
- type
-
- Type: string
The type of this data source.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this data source was updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteDomain
$result = $client->deleteDomain
([/* ... */]); $promise = $client->deleteDomainAsync
([/* ... */]);
Deletes a Amazon DataZone domain.
Parameter Syntax
$result = $client->deleteDomain([ 'clientToken' => '<string>', 'identifier' => '<string>', // REQUIRED 'skipDeletionCheck' => true || false, ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- identifier
-
- Required: Yes
- Type: string
The identifier of the Amazon Web Services domain that is to be deleted.
- skipDeletionCheck
-
- Type: boolean
Specifies the optional flag to delete all child entities within the domain.
Result Syntax
[ 'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED', ]
Result Details
Members
- status
-
- Required: Yes
- Type: string
The status of the domain.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteDomainUnit
$result = $client->deleteDomainUnit
([/* ... */]); $promise = $client->deleteDomainUnitAsync
([/* ... */]);
Deletes a domain unit.
Parameter Syntax
$result = $client->deleteDomainUnit([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to delete a domain unit.
- identifier
-
- Required: Yes
- Type: string
The ID of the domain unit that you want to delete.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
DeleteProjectProfile
$result = $client->deleteProjectProfile
([/* ... */]); $promise = $client->deleteProjectProfileAsync
([/* ... */]);
Deletes a project profile.
Parameter Syntax
$result = $client->deleteProjectProfile([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where a project profile is deleted.
- identifier
-
- Required: Yes
- Type: string
The ID of the project profile that is deleted.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteRule
$result = $client->deleteRule
([/* ... */]); $promise = $client->deleteRuleAsync
([/* ... */]);
Deletes a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.
Parameter Syntax
$result = $client->deleteRule([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain that where the rule is to be deleted.
- identifier
-
- Required: Yes
- Type: string
The ID of the rule that is to be deleted.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteSubscriptionGrant
$result = $client->deleteSubscriptionGrant
([/* ... */]); $promise = $client->deleteSubscriptionGrantAsync
([/* ... */]);
Deletes and subscription grant in Amazon DataZone.
Parameter Syntax
$result = $client->deleteSubscriptionGrant([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where the subscription grant is deleted.
- identifier
-
- Required: Yes
- Type: string
The ID of the subscription grant that is deleted.
Result Syntax
[ 'assets' => [ [ 'assetId' => '<string>', 'assetRevision' => '<string>', 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'failureCause' => [ 'message' => '<string>', ], 'failureTimestamp' => <DateTime>, 'grantedTimestamp' => <DateTime>, 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED', 'targetName' => '<string>', ], // ... ], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'grantedEntity' => [ 'listing' => [ 'id' => '<string>', 'revision' => '<string>', ], ], 'id' => '<string>', 'status' => 'PENDING|IN_PROGRESS|GRANT_FAILED|REVOKE_FAILED|GRANT_AND_REVOKE_FAILED|COMPLETED|INACCESSIBLE', 'subscriptionId' => '<string>', 'subscriptionTargetId' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- assets
-
- Type: Array of SubscribedAsset structures
The assets for which the subsctiption grant that is deleted gave access.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription grant that is deleted was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription grant that is deleted.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription grant is deleted.
- grantedEntity
-
- Required: Yes
- Type: GrantedEntity structure
The entity to which the subscription is deleted.
- id
-
- Required: Yes
- Type: string
The ID of the subscription grant that is deleted.
- status
-
- Required: Yes
- Type: string
The status of the subscription grant that is deleted.
- subscriptionId
-
- Type: string
The identifier of the subsctiption whose subscription grant is to be deleted.
- subscriptionTargetId
-
- Required: Yes
- Type: string
The ID of the subscription target associated with the subscription grant that is deleted.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription grant that is deleted was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription grant that is deleted.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
DeleteSubscriptionRequest
$result = $client->deleteSubscriptionRequest
([/* ... */]); $promise = $client->deleteSubscriptionRequestAsync
([/* ... */]);
Deletes a subscription request in Amazon DataZone.
Parameter Syntax
$result = $client->deleteSubscriptionRequest([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription request is deleted.
- identifier
-
- Required: Yes
- Type: string
The ID of the subscription request that is deleted.
Result Syntax
[]
Result Details
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
GetConnection
$result = $client->getConnection
([/* ... */]); $promise = $client->getConnectionAsync
([/* ... */]);
Gets a connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.
Parameter Syntax
$result = $client->getConnection([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'withSecret' => true || false, ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where we get the connection.
- identifier
-
- Required: Yes
- Type: string
The connection ID.
- withSecret
-
- Type: boolean
Specifies whether a connection has a secret.
Result Syntax
[ 'connectionCredentials' => [ 'accessKeyId' => '<string>', 'expiration' => <DateTime>, 'secretAccessKey' => '<string>', 'sessionToken' => '<string>', ], 'connectionId' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentId' => '<string>', 'environmentUserRole' => '<string>', 'name' => '<string>', 'physicalEndpoints' => [ [ 'awsLocation' => [ 'accessRole' => '<string>', 'awsAccountId' => '<string>', 'awsRegion' => '<string>', 'iamConnectionId' => '<string>', ], 'glueConnection' => [ 'athenaProperties' => ['<string>', ...], 'authenticationConfiguration' => [ 'authenticationType' => 'BASIC|OAUTH2|CUSTOM', 'oAuth2Properties' => [ 'authorizationCodeProperties' => [ 'authorizationCode' => '<string>', 'redirectUri' => '<string>', ], 'oAuth2ClientApplication' => [ 'aWSManagedClientApplicationReference' => '<string>', 'userManagedClientApplicationClientId' => '<string>', ], 'oAuth2Credentials' => [ 'accessToken' => '<string>', 'jwtToken' => '<string>', 'refreshToken' => '<string>', 'userManagedClientApplicationClientSecret' => '<string>', ], 'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER', 'tokenUrl' => '<string>', 'tokenUrlParametersMap' => ['<string>', ...], ], 'secretArn' => '<string>', ], 'compatibleComputeEnvironments' => ['<string>', ...], 'connectionProperties' => ['<string>', ...], 'connectionSchemaVersion' => <integer>, 'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', 'creationTime' => <DateTime>, 'description' => '<string>', 'lastConnectionValidationTime' => <DateTime>, 'lastUpdatedBy' => '<string>', 'lastUpdatedTime' => <DateTime>, 'matchCriteria' => ['<string>', ...], 'name' => '<string>', 'physicalConnectionRequirements' => [ 'availabilityZone' => '<string>', 'securityGroupIdList' => ['<string>', ...], 'subnetId' => '<string>', 'subnetIdList' => ['<string>', ...], ], 'pythonProperties' => ['<string>', ...], 'sparkProperties' => ['<string>', ...], 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'statusReason' => '<string>', ], 'glueConnectionName' => '<string>', 'host' => '<string>', 'port' => <integer>, 'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM', 'stage' => '<string>', ], // ... ], 'projectId' => '<string>', 'props' => [ 'athenaProperties' => [ 'workgroupName' => '<string>', ], 'glueProperties' => [ 'errorMessage' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', ], 'hyperPodProperties' => [ 'clusterArn' => '<string>', 'clusterName' => '<string>', 'orchestrator' => 'EKS|SLURM', ], 'iamProperties' => [ 'environmentId' => '<string>', 'glueLineageSyncEnabled' => true || false, ], 'redshiftProperties' => [ 'credentials' => [ 'secretArn' => '<string>', 'usernamePassword' => [ 'password' => '<string>', 'username' => '<string>', ], ], 'databaseName' => '<string>', 'isProvisionedSecret' => true || false, 'jdbcIamUrl' => '<string>', 'jdbcUrl' => '<string>', 'lineageSync' => [ 'enabled' => true || false, 'lineageJobId' => '<string>', 'schedule' => [ 'schedule' => '<string>', ], ], 'redshiftTempDir' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'storage' => [ 'clusterName' => '<string>', 'workgroupName' => '<string>', ], ], 'sparkEmrProperties' => [ 'computeArn' => '<string>', 'credentials' => [ 'password' => '<string>', 'username' => '<string>', ], 'credentialsExpiration' => <DateTime>, 'governanceType' => 'AWS_MANAGED|USER_MANAGED', 'instanceProfileArn' => '<string>', 'javaVirtualEnv' => '<string>', 'livyEndpoint' => '<string>', 'logUri' => '<string>', 'pythonVirtualEnv' => '<string>', 'runtimeRole' => '<string>', 'trustedCertificatesS3Uri' => '<string>', ], 'sparkGlueProperties' => [ 'additionalArgs' => [ 'connection' => '<string>', ], 'glueConnectionName' => '<string>', 'glueVersion' => '<string>', 'idleTimeout' => <integer>, 'javaVirtualEnv' => '<string>', 'numberOfWorkers' => <integer>, 'pythonVirtualEnv' => '<string>', 'workerType' => '<string>', ], ], 'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', ]
Result Details
Members
- connectionCredentials
-
- Type: ConnectionCredentials structure
Connection credentials.
- connectionId
-
- Required: Yes
- Type: string
The ID of the connection.
- description
-
- Type: string
Connection description.
- domainId
-
- Required: Yes
- Type: string
The domain ID of the connection.
- domainUnitId
-
- Required: Yes
- Type: string
The domain unit ID of the connection.
- environmentId
-
- Type: string
The ID of the environment.
- environmentUserRole
-
- Type: string
The environment user role.
- name
-
- Required: Yes
- Type: string
The name of the connection.
- physicalEndpoints
-
- Required: Yes
- Type: Array of PhysicalEndpoint structures
The physical endpoints of the connection.
- projectId
-
- Type: string
The ID of the project.
- props
-
- Type: ConnectionPropertiesOutput structure
Connection props.
- type
-
- Required: Yes
- Type: string
The type of the connection.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetDataProduct
$result = $client->getDataProduct
([/* ... */]); $promise = $client->getDataProductAsync
([/* ... */]);
Gets the data product.
Parameter Syntax
$result = $client->getDataProduct([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'revision' => '<string>', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the data product lives.
- identifier
-
- Required: Yes
- Type: string
The ID of the data product.
- revision
-
- Type: string
The revision of the data product.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'firstRevisionCreatedAt' => <DateTime>, 'firstRevisionCreatedBy' => '<string>', 'formsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'items' => [ [ 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', 'itemType' => 'ASSET', 'revision' => '<string>', ], // ... ], 'name' => '<string>', 'owningProjectId' => '<string>', 'revision' => '<string>', 'status' => 'CREATED|CREATING|CREATE_FAILED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data product is created.
- createdBy
-
- Type: string
The user who created the data product.
- description
-
- Type: string
The description of the data product.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where the data product lives.
- firstRevisionCreatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the first revision of the data product is created.
- firstRevisionCreatedBy
-
- Type: string
The user who created the first revision of the data product.
- formsOutput
-
- Type: Array of FormOutput structures
The metadata forms of the data product.
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the data product.
- id
-
- Required: Yes
- Type: string
The ID of the data product.
- items
-
- Type: Array of DataProductItem structures
The data assets of the data product.
- name
-
- Required: Yes
- Type: string
The name of the data product.
- owningProjectId
-
- Required: Yes
- Type: string
The ID of the owning project of the data product.
- revision
-
- Required: Yes
- Type: string
The revision of the data product.
- status
-
- Required: Yes
- Type: string
The status of the data product.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetDataSource
$result = $client->getDataSource
([/* ... */]); $promise = $client->getDataSourceAsync
([/* ... */]);
Gets an Amazon DataZone data source.
Parameter Syntax
$result = $client->getDataSource([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data source exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone data source.
Result Syntax
[ 'assetFormsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'configuration' => [ 'glueRunConfiguration' => [ 'accountId' => '<string>', 'autoImportDataQualityResult' => true || false, 'catalogName' => '<string>', 'dataAccessRole' => '<string>', 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'redshiftRunConfiguration' => [ 'accountId' => '<string>', 'dataAccessRole' => '<string>', 'redshiftCredentialConfiguration' => [ 'secretManagerArn' => '<string>', ], 'redshiftStorage' => [ 'redshiftClusterSource' => [ 'clusterName' => '<string>', ], 'redshiftServerlessSource' => [ 'workgroupName' => '<string>', ], ], 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'sageMakerRunConfiguration' => [ 'accountId' => '<string>', 'region' => '<string>', 'trackingAssets' => [ '<SageMakerAssetType>' => ['<string>', ...], // ... ], ], ], 'connectionId' => '<string>', 'createdAt' => <DateTime>, 'description' => '<string>', 'domainId' => '<string>', 'enableSetting' => 'ENABLED|DISABLED', 'environmentId' => '<string>', 'errorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'id' => '<string>', 'lastRunAssetCount' => <integer>, 'lastRunAt' => <DateTime>, 'lastRunErrorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'lastRunStatus' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS', 'name' => '<string>', 'projectId' => '<string>', 'publishOnImport' => true || false, 'recommendation' => [ 'enableBusinessNameGeneration' => true || false, ], 'schedule' => [ 'schedule' => '<string>', 'timezone' => 'UTC|AFRICA_JOHANNESBURG|AMERICA_MONTREAL|AMERICA_SAO_PAULO|ASIA_BAHRAIN|ASIA_BANGKOK|ASIA_CALCUTTA|ASIA_DUBAI|ASIA_HONG_KONG|ASIA_JAKARTA|ASIA_KUALA_LUMPUR|ASIA_SEOUL|ASIA_SHANGHAI|ASIA_SINGAPORE|ASIA_TAIPEI|ASIA_TOKYO|AUSTRALIA_MELBOURNE|AUSTRALIA_SYDNEY|CANADA_CENTRAL|CET|CST6CDT|ETC_GMT|ETC_GMT0|ETC_GMT_ADD_0|ETC_GMT_ADD_1|ETC_GMT_ADD_10|ETC_GMT_ADD_11|ETC_GMT_ADD_12|ETC_GMT_ADD_2|ETC_GMT_ADD_3|ETC_GMT_ADD_4|ETC_GMT_ADD_5|ETC_GMT_ADD_6|ETC_GMT_ADD_7|ETC_GMT_ADD_8|ETC_GMT_ADD_9|ETC_GMT_NEG_0|ETC_GMT_NEG_1|ETC_GMT_NEG_10|ETC_GMT_NEG_11|ETC_GMT_NEG_12|ETC_GMT_NEG_13|ETC_GMT_NEG_14|ETC_GMT_NEG_2|ETC_GMT_NEG_3|ETC_GMT_NEG_4|ETC_GMT_NEG_5|ETC_GMT_NEG_6|ETC_GMT_NEG_7|ETC_GMT_NEG_8|ETC_GMT_NEG_9|EUROPE_DUBLIN|EUROPE_LONDON|EUROPE_PARIS|EUROPE_STOCKHOLM|EUROPE_ZURICH|ISRAEL|MEXICO_GENERAL|MST7MDT|PACIFIC_AUCKLAND|US_CENTRAL|US_EASTERN|US_MOUNTAIN|US_PACIFIC', ], 'selfGrantStatus' => [ 'glueSelfGrantStatus' => [ 'selfGrantStatusDetails' => [ [ 'databaseName' => '<string>', 'failureCause' => '<string>', 'schemaName' => '<string>', 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED', ], // ... ], ], 'redshiftSelfGrantStatus' => [ 'selfGrantStatusDetails' => [ [ 'databaseName' => '<string>', 'failureCause' => '<string>', 'schemaName' => '<string>', 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|GRANT_FAILED|REVOKE_FAILED', ], // ... ], ], ], 'status' => 'CREATING|FAILED_CREATION|READY|UPDATING|FAILED_UPDATE|RUNNING|DELETING|FAILED_DELETION', 'type' => '<string>', 'updatedAt' => <DateTime>, ]
Result Details
Members
- assetFormsOutput
-
- Type: Array of FormOutput structures
The metadata forms attached to the assets created by this data source.
- configuration
-
- Type: DataSourceConfigurationOutput structure
The configuration of the data source.
- connectionId
-
- Type: string
The ID of the connection.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was created.
- description
-
- Type: string
The description of the data source.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data source exists.
- enableSetting
-
- Type: string
Specifies whether this data source is enabled or not.
- environmentId
-
- Type: string
The ID of the environment where this data source creates and publishes assets,
- errorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The ID of the data source.
- lastRunAssetCount
-
- Type: int
The number of assets created by the data source during its last run.
- lastRunAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of the last run of the data source.
- lastRunErrorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- lastRunStatus
-
- Type: string
The status of the last run of the data source.
- name
-
- Required: Yes
- Type: string
The name of the data source.
- projectId
-
- Required: Yes
- Type: string
The ID of the project where the data source creates and publishes assets.
- publishOnImport
-
- Type: boolean
Specifies whether the assets that this data source creates in the inventory are to be also automatically published to the catalog.
- recommendation
-
- Type: RecommendationConfiguration structure
The recommendation configuration of the data source.
- schedule
-
- Type: ScheduleConfiguration structure
The schedule of the data source runs.
- selfGrantStatus
-
- Type: SelfGrantStatusOutput structure
Specifies the status of the self-granting functionality.
- status
-
- Type: string
The status of the data source.
- type
-
- Type: string
The type of the data source.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetDataSourceRun
$result = $client->getDataSourceRun
([/* ... */]); $promise = $client->getDataSourceRunAsync
([/* ... */]);
Gets an Amazon DataZone data source run.
Parameter Syntax
$result = $client->getDataSourceRun([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain in which this data source run was performed.
- identifier
-
- Required: Yes
- Type: string
The ID of the data source run.
Result Syntax
[ 'createdAt' => <DateTime>, 'dataSourceConfigurationSnapshot' => '<string>', 'dataSourceId' => '<string>', 'domainId' => '<string>', 'errorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'id' => '<string>', 'lineageSummary' => [ 'importStatus' => 'IN_PROGRESS|SUCCESS|FAILED|PARTIALLY_SUCCEEDED', ], 'projectId' => '<string>', 'runStatisticsForAssets' => [ 'added' => <integer>, 'failed' => <integer>, 'skipped' => <integer>, 'unchanged' => <integer>, 'updated' => <integer>, ], 'startedAt' => <DateTime>, 'status' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS', 'stoppedAt' => <DateTime>, 'type' => 'PRIORITIZED|SCHEDULED', 'updatedAt' => <DateTime>, ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source run was created.
- dataSourceConfigurationSnapshot
-
- Type: string
The configuration snapshot of the data source run.
- dataSourceId
-
- Required: Yes
- Type: string
The ID of the data source for this data source run.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain in which this data source run was performed.
- errorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The ID of the data source run.
- lineageSummary
-
- Type: DataSourceRunLineageSummary structure
The summary of the data lineage.
- projectId
-
- Required: Yes
- Type: string
The ID of the project in which this data source run occured.
- runStatisticsForAssets
-
- Type: RunStatisticsForAssets structure
The asset statistics from this data source run.
- startedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this data source run started.
- status
-
- Required: Yes
- Type: string
The status of this data source run.
- stoppedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this data source run stopped.
- type
-
- Required: Yes
- Type: string
The type of this data source run.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this data source run was updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetDomain
$result = $client->getDomain
([/* ... */]); $promise = $client->getDomainAsync
([/* ... */]);
Gets an Amazon DataZone domain.
Parameter Syntax
$result = $client->getDomain([ 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- identifier
-
- Required: Yes
- Type: string
The identifier of the specified Amazon DataZone domain.
Result Syntax
[ 'arn' => '<string>', 'createdAt' => <DateTime>, 'description' => '<string>', 'domainExecutionRole' => '<string>', 'domainVersion' => 'V1|V2', 'id' => '<string>', 'kmsKeyIdentifier' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'portalUrl' => '<string>', 'rootDomainUnitId' => '<string>', 'serviceRole' => '<string>', 'singleSignOn' => [ 'type' => 'IAM_IDC|DISABLED', 'userAssignment' => 'AUTOMATIC|MANUAL', ], 'status' => 'CREATING|AVAILABLE|CREATION_FAILED|DELETING|DELETED|DELETION_FAILED', 'tags' => ['<string>', ...], ]
Result Details
Members
- arn
-
- Type: string
The ARN of the specified Amazon DataZone domain.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the Amazon DataZone domain was created.
- description
-
- Type: string
The description of the Amazon DataZone domain.
- domainExecutionRole
-
- Required: Yes
- Type: string
The domain execution role with which the Amazon DataZone domain is created.
- domainVersion
-
- Type: string
The version of the domain.
- id
-
- Required: Yes
- Type: string
The identifier of the specified Amazon DataZone domain.
- kmsKeyIdentifier
-
- Type: string
The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the Amazon DataZone domain was last updated.
- name
-
- Type: string
The name of the Amazon DataZone domain.
- portalUrl
-
- Type: string
The URL of the data portal for this Amazon DataZone domain.
- rootDomainUnitId
-
- Type: string
The ID of the root domain in Amazon Datazone.
- serviceRole
-
- Type: string
The service role of the domain.
- singleSignOn
-
- Type: SingleSignOn structure
The single sing-on option of the specified Amazon DataZone domain.
- status
-
- Required: Yes
- Type: string
The status of the specified Amazon DataZone domain.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags specified for the Amazon DataZone domain.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetDomainUnit
$result = $client->getDomainUnit
([/* ... */]); $promise = $client->getDomainUnitAsync
([/* ... */]);
Gets the details of the specified domain unit.
Parameter Syntax
$result = $client->getDomainUnit([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to get a domain unit.
- identifier
-
- Required: Yes
- Type: string
The identifier of the domain unit that you want to get.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'lastUpdatedBy' => '<string>', 'name' => '<string>', 'owners' => [ [ 'group' => [ 'groupId' => '<string>', ], 'user' => [ 'userId' => '<string>', ], ], // ... ], 'parentDomainUnitId' => '<string>', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time stamp at which the domain unit was created.
- createdBy
-
- Type: string
The user who created the domain unit.
- description
-
- Type: string
The description of the domain unit.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain in which the domain unit lives.
- id
-
- Required: Yes
- Type: string
The ID of the domain unit.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the domain unit was last updated.
- lastUpdatedBy
-
- Type: string
The user who last updated the domain unit.
- name
-
- Required: Yes
- Type: string
The name of the domain unit.
- owners
-
- Required: Yes
- Type: Array of DomainUnitOwnerProperties structures
The owners of the domain unit.
- parentDomainUnitId
-
- Type: string
The ID of the parent domain unit.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetEnvironment
$result = $client->getEnvironment
([/* ... */]); $promise = $client->getEnvironmentAsync
([/* ... */]);
Gets an Amazon DataZone environment.
Parameter Syntax
$result = $client->getEnvironment([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where the environment exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone environment.
Result Syntax
[ 'awsAccountId' => '<string>', 'awsAccountRegion' => '<string>', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'deploymentProperties' => [ 'endTimeoutMinutes' => <integer>, 'startTimeoutMinutes' => <integer>, ], 'description' => '<string>', 'domainId' => '<string>', 'environmentActions' => [ [ 'auth' => 'IAM|HTTPS', 'parameters' => [ [ 'key' => '<string>', 'value' => '<string>', ], // ... ], 'type' => '<string>', ], // ... ], 'environmentBlueprintId' => '<string>', 'environmentProfileId' => '<string>', 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'lastDeployment' => [ 'deploymentId' => '<string>', 'deploymentStatus' => 'IN_PROGRESS|SUCCESSFUL|FAILED|PENDING_DEPLOYMENT', 'deploymentType' => 'CREATE|UPDATE|DELETE', 'failureReason' => [ 'code' => '<string>', 'message' => '<string>', ], 'isDeploymentComplete' => true || false, 'messages' => ['<string>', ...], ], 'name' => '<string>', 'projectId' => '<string>', 'provider' => '<string>', 'provisionedResources' => [ [ 'name' => '<string>', 'provider' => '<string>', 'type' => '<string>', 'value' => '<string>', ], // ... ], 'provisioningProperties' => [ 'cloudFormation' => [ 'templateUrl' => '<string>', ], ], 'status' => 'ACTIVE|CREATING|UPDATING|DELETING|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED|VALIDATION_FAILED|SUSPENDED|DISABLED|EXPIRED|DELETED|INACCESSIBLE', 'updatedAt' => <DateTime>, 'userParameters' => [ [ 'defaultValue' => '<string>', 'description' => '<string>', 'fieldType' => '<string>', 'isEditable' => true || false, 'isOptional' => true || false, 'keyName' => '<string>', ], // ... ], ]
Result Details
Members
- awsAccountId
-
- Type: string
The ID of the Amazon Web Services account where the environment exists.
- awsAccountRegion
-
- Type: string
The Amazon Web Services region where the environment exists.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the environment.
- deploymentProperties
-
- Type: DeploymentProperties structure
The deployment properties of the environment.
- description
-
- Type: string
The description of the environment.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where the environment exists.
- environmentActions
-
- Type: Array of ConfigurableEnvironmentAction structures
The actions of the environment.
- environmentBlueprintId
-
- Type: string
The blueprint with which the environment is created.
- environmentProfileId
-
- Type: string
The ID of the environment profile with which the environment is created.
- glossaryTerms
-
- Type: Array of strings
The business glossary terms that can be used in this environment.
- id
-
- Type: string
The ID of the environment.
- lastDeployment
-
- Type: Deployment structure
The details of the last deployment of the environment.
- name
-
- Required: Yes
- Type: string
The name of the environment.
- projectId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone project in which this environment is created.
- provider
-
- Required: Yes
- Type: string
The provider of this Amazon DataZone environment.
- provisionedResources
-
- Type: Array of Resource structures
The provisioned resources of this Amazon DataZone environment.
- provisioningProperties
-
- Type: ProvisioningProperties structure
The provisioning properties of this Amazon DataZone environment.
- status
-
- Type: string
The status of this Amazon DataZone environment.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this environment was updated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters of this Amazon DataZone environment.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetEnvironmentAction
$result = $client->getEnvironmentAction
([/* ... */]); $promise = $client->getEnvironmentActionAsync
([/* ... */]);
Gets the specified environment action.
Parameter Syntax
$result = $client->getEnvironmentAction([ 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the
GetEnvironmentAction
API is invoked. - environmentIdentifier
-
- Required: Yes
- Type: string
The environment ID of the environment action.
- identifier
-
- Required: Yes
- Type: string
The ID of the environment action
Result Syntax
[ 'description' => '<string>', 'domainId' => '<string>', 'environmentId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'parameters' => [ 'awsConsoleLink' => [ 'uri' => '<string>', ], ], ]
Result Details
Members
- description
-
- Type: string
The description of the environment action.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the environment action lives.
- environmentId
-
- Required: Yes
- Type: string
The environment ID of the environment action.
- id
-
- Required: Yes
- Type: string
The ID of the environment action.
- name
-
- Required: Yes
- Type: string
The name of the environment action.
- parameters
-
- Required: Yes
- Type: ActionParameters structure
The parameters of the environment action.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetEnvironmentBlueprint
$result = $client->getEnvironmentBlueprint
([/* ... */]); $promise = $client->getEnvironmentBlueprintAsync
([/* ... */]);
Gets an Amazon DataZone blueprint.
Parameter Syntax
$result = $client->getEnvironmentBlueprint([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the domain in which this blueprint exists.
- identifier
-
- Required: Yes
- Type: string
The ID of this Amazon DataZone blueprint.
Result Syntax
[ 'createdAt' => <DateTime>, 'deploymentProperties' => [ 'endTimeoutMinutes' => <integer>, 'startTimeoutMinutes' => <integer>, ], 'description' => '<string>', 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'name' => '<string>', 'provider' => '<string>', 'provisioningProperties' => [ 'cloudFormation' => [ 'templateUrl' => '<string>', ], ], 'updatedAt' => <DateTime>, 'userParameters' => [ [ 'defaultValue' => '<string>', 'description' => '<string>', 'fieldType' => '<string>', 'isEditable' => true || false, 'isOptional' => true || false, 'keyName' => '<string>', ], // ... ], ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp of when this blueprint was created.
- deploymentProperties
-
- Type: DeploymentProperties structure
The deployment properties of this Amazon DataZone blueprint.
- description
-
- Type: string
The description of this Amazon DataZone blueprint.
- glossaryTerms
-
- Type: Array of strings
The glossary terms attached to this Amazon DataZone blueprint.
- id
-
- Required: Yes
- Type: string
The ID of this Amazon DataZone blueprint.
- name
-
- Required: Yes
- Type: string
The name of this Amazon DataZone blueprint.
- provider
-
- Required: Yes
- Type: string
The provider of this Amazon DataZone blueprint.
- provisioningProperties
-
- Required: Yes
- Type: ProvisioningProperties structure
The provisioning properties of this Amazon DataZone blueprint.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this blueprint was updated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters of this blueprint.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetEnvironmentBlueprintConfiguration
$result = $client->getEnvironmentBlueprintConfiguration
([/* ... */]); $promise = $client->getEnvironmentBlueprintConfigurationAsync
([/* ... */]);
Gets the blueprint configuration in Amazon DataZone.
Parameter Syntax
$result = $client->getEnvironmentBlueprintConfiguration([ 'domainIdentifier' => '<string>', // REQUIRED 'environmentBlueprintIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where this blueprint exists.
- environmentBlueprintIdentifier
-
- Required: Yes
- Type: string
He ID of the blueprint.
Result Syntax
[ 'createdAt' => <DateTime>, 'domainId' => '<string>', 'enabledRegions' => ['<string>', ...], 'environmentBlueprintId' => '<string>', 'environmentRolePermissionBoundary' => '<string>', 'manageAccessRoleArn' => '<string>', 'provisioningConfigurations' => [ [ 'lakeFormationConfiguration' => [ 'locationRegistrationExcludeS3Locations' => ['<string>', ...], 'locationRegistrationRole' => '<string>', ], ], // ... ], 'provisioningRoleArn' => '<string>', 'regionalParameters' => [ '<RegionName>' => ['<string>', ...], // ... ], 'updatedAt' => <DateTime>, ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this blueprint was created.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where this blueprint exists.
- enabledRegions
-
- Type: Array of strings
The Amazon Web Services regions in which this blueprint is enabled.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The ID of the blueprint.
- environmentRolePermissionBoundary
-
- Type: string
The environment role permissions boundary.
- manageAccessRoleArn
-
- Type: string
The ARN of the manage access role with which this blueprint is created.
- provisioningConfigurations
-
- Type: Array of ProvisioningConfiguration structures
The provisioning configuration of a blueprint.
- provisioningRoleArn
-
- Type: string
The ARN of the provisioning role with which this blueprint is created.
- regionalParameters
-
- Type: Associative array of custom strings keys (RegionName) to stringss
The regional parameters of the blueprint.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this blueprint was upated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetEnvironmentCredentials
$result = $client->getEnvironmentCredentials
([/* ... */]); $promise = $client->getEnvironmentCredentialsAsync
([/* ... */]);
Gets the credentials of an environment in Amazon DataZone.
Parameter Syntax
$result = $client->getEnvironmentCredentials([ 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this environment and its credentials exist.
- environmentIdentifier
-
- Required: Yes
- Type: string
The ID of the environment whose credentials this operation gets.
Result Syntax
[ 'accessKeyId' => '<string>', 'expiration' => <DateTime>, 'secretAccessKey' => '<string>', 'sessionToken' => '<string>', ]
Result Details
Members
- accessKeyId
-
- Type: string
The access key ID of the environment.
- expiration
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The expiration timestamp of the environment credentials.
- secretAccessKey
-
- Type: string
The secret access key of the environment credentials.
- sessionToken
-
- Type: string
The session token of the environment credentials.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetEnvironmentProfile
$result = $client->getEnvironmentProfile
([/* ... */]); $promise = $client->getEnvironmentProfileAsync
([/* ... */]);
Gets an evinronment profile in Amazon DataZone.
Parameter Syntax
$result = $client->getEnvironmentProfile([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this environment profile exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the environment profile.
Result Syntax
[ 'awsAccountId' => '<string>', 'awsAccountRegion' => '<string>', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'environmentBlueprintId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'projectId' => '<string>', 'updatedAt' => <DateTime>, 'userParameters' => [ [ 'defaultValue' => '<string>', 'description' => '<string>', 'fieldType' => '<string>', 'isEditable' => true || false, 'isOptional' => true || false, 'keyName' => '<string>', ], // ... ], ]
Result Details
Members
- awsAccountId
-
- Type: string
The ID of the Amazon Web Services account where this environment profile exists.
- awsAccountRegion
-
- Type: string
The Amazon Web Services region where this environment profile exists.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this environment profile was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created this environment profile.
- description
-
- Type: string
The description of the environment profile.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this environment profile exists.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The ID of the blueprint with which this environment profile is created.
- id
-
- Required: Yes
- Type: string
The ID of the environment profile.
- name
-
- Required: Yes
- Type: string
The name of the environment profile.
- projectId
-
- Type: string
The ID of the Amazon DataZone project in which this environment profile is created.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this environment profile was upated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters of the environment profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetFormType
$result = $client->getFormType
([/* ... */]); $promise = $client->getFormTypeAsync
([/* ... */]);
Gets a metadata form type in Amazon DataZone.
Parameter Syntax
$result = $client->getFormType([ 'domainIdentifier' => '<string>', // REQUIRED 'formTypeIdentifier' => '<string>', // REQUIRED 'revision' => '<string>', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this metadata form type exists.
- formTypeIdentifier
-
- Required: Yes
- Type: string
The ID of the metadata form type.
- revision
-
- Type: string
The revision of this metadata form type.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'imports' => [ [ 'name' => '<string>', 'revision' => '<string>', ], // ... ], 'model' => [ 'smithy' => '<string>', ], 'name' => '<string>', 'originDomainId' => '<string>', 'originProjectId' => '<string>', 'owningProjectId' => '<string>', 'revision' => '<string>', 'status' => 'ENABLED|DISABLED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this metadata form type was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created this metadata form type.
- description
-
- Type: string
The description of the metadata form type.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this metadata form type exists.
- imports
-
- Type: Array of Import structures
The imports of the metadata form type.
- model
-
- Required: Yes
- Type: Model structure
The model of the metadata form type.
- name
-
- Required: Yes
- Type: string
The name of the metadata form type.
- originDomainId
-
- Type: string
The ID of the Amazon DataZone domain in which the metadata form type was originally created.
- originProjectId
-
- Type: string
The ID of the project in which this metadata form type was originally created.
- owningProjectId
-
- Type: string
The ID of the project that owns this metadata form type.
- revision
-
- Required: Yes
- Type: string
The revision of the metadata form type.
- status
-
- Type: string
The status of the metadata form type.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetGlossary
$result = $client->getGlossary
([/* ... */]); $promise = $client->getGlossaryAsync
([/* ... */]);
Gets a business glossary in Amazon DataZone.
Parameter Syntax
$result = $client->getGlossary([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the business glossary.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', 'status' => 'DISABLED|ENABLED', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when this business glossary was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created this business glossary.
- description
-
- Type: string
The description of the business glossary.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary exists.
- id
-
- Required: Yes
- Type: string
The ID of the business glossary.
- name
-
- Required: Yes
- Type: string
The name of the business glossary.
- owningProjectId
-
- Required: Yes
- Type: string
The ID of the project that owns this business glossary.
- status
-
- Required: Yes
- Type: string
The status of the business glossary.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the business glossary was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the business glossary.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetGlossaryTerm
$result = $client->getGlossaryTerm
([/* ... */]); $promise = $client->getGlossaryTermAsync
([/* ... */]);
Gets a business glossary term in Amazon DataZone.
Parameter Syntax
$result = $client->getGlossaryTerm([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary term exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the business glossary term.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'glossaryId' => '<string>', 'id' => '<string>', 'longDescription' => '<string>', 'name' => '<string>', 'shortDescription' => '<string>', 'status' => 'ENABLED|DISABLED', 'termRelations' => [ 'classifies' => ['<string>', ...], 'isA' => ['<string>', ...], ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the business glossary term was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created the business glossary.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which this business glossary term exists.
- glossaryId
-
- Required: Yes
- Type: string
The ID of the business glossary to which this term belongs.
- id
-
- Required: Yes
- Type: string
The ID of the business glossary term.
- longDescription
-
- Type: string
The long description of the business glossary term.
- name
-
- Required: Yes
- Type: string
The name of the business glossary term.
- shortDescription
-
- Type: string
The short decription of the business glossary term.
- status
-
- Required: Yes
- Type: string
The status of the business glossary term.
- termRelations
-
- Type: TermRelations structure
The relations of the business glossary term.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the business glossary term was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the business glossary term.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetGroupProfile
$result = $client->getGroupProfile
([/* ... */]); $promise = $client->getGroupProfileAsync
([/* ... */]);
Gets a group profile in Amazon DataZone.
Parameter Syntax
$result = $client->getGroupProfile([ 'domainIdentifier' => '<string>', // REQUIRED 'groupIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the group profile exists.
- groupIdentifier
-
- Required: Yes
- Type: string
The identifier of the group profile.
Result Syntax
[ 'domainId' => '<string>', 'groupName' => '<string>', 'id' => '<string>', 'status' => 'ASSIGNED|NOT_ASSIGNED', ]
Result Details
Members
- domainId
-
- Type: string
The identifier of the Amazon DataZone domain in which the group profile exists.
- groupName
-
- Type: string
The name of the group for which the specified group profile exists.
- id
-
- Type: string
The identifier of the group profile.
- status
-
- Type: string
The identifier of the group profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetIamPortalLoginUrl
$result = $client->getIamPortalLoginUrl
([/* ... */]); $promise = $client->getIamPortalLoginUrlAsync
([/* ... */]);
Gets the data portal URL for the specified Amazon DataZone domain.
Parameter Syntax
$result = $client->getIamPortalLoginUrl([ 'domainIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
the ID of the Amazon DataZone domain the data portal of which you want to get.
Result Syntax
[ 'authCodeUrl' => '<string>', 'userProfileId' => '<string>', ]
Result Details
Members
- authCodeUrl
-
- Type: string
The data portal URL of the specified Amazon DataZone domain.
- userProfileId
-
- Required: Yes
- Type: string
The ID of the user profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetJobRun
$result = $client->getJobRun
([/* ... */]); $promise = $client->getJobRunAsync
([/* ... */]);
The details of the job run.
Parameter Syntax
$result = $client->getJobRun([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain.
- identifier
-
- Required: Yes
- Type: string
The ID of the job run.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'details' => [ 'lineageRunDetails' => [ 'sqlQueryRunDetails' => [ 'errorMessages' => ['<string>', ...], 'numQueriesFailed' => <integer>, 'queryEndTime' => <DateTime>, 'queryStartTime' => <DateTime>, 'totalQueriesProcessed' => <integer>, ], ], ], 'domainId' => '<string>', 'endTime' => <DateTime>, 'error' => [ 'message' => '<string>', ], 'id' => '<string>', 'jobId' => '<string>', 'jobType' => 'LINEAGE', 'runMode' => 'SCHEDULED|ON_DEMAND', 'startTime' => <DateTime>, 'status' => 'SCHEDULED|IN_PROGRESS|SUCCESS|PARTIALLY_SUCCEEDED|FAILED|ABORTED|TIMED_OUT|CANCELED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the job run was created.
- createdBy
-
- Type: string
The user who created the job run.
- details
-
- Type: JobRunDetails structure
The details of the job run.
- domainId
-
- Type: string
The ID of the domain.
- endTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the job run ended.
- error
-
- Type: JobRunError structure
The error generated if the action is not completed successfully.
- id
-
- Type: string
The ID of the job run.
- jobId
-
- Type: string
The ID of the job run.
- jobType
-
- Type: string
The type of the job run.
- runMode
-
- Type: string
The mode of the job run.
- startTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the job run started.
- status
-
- Type: string
The status of the job run.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetLineageEvent
$result = $client->getLineageEvent
([/* ... */]); $promise = $client->getLineageEventAsync
([/* ... */]);
Describes the lineage event.
Parameter Syntax
$result = $client->getLineageEvent([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain.
- identifier
-
- Required: Yes
- Type: string
The ID of the lineage event.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'event' => <string || resource || Psr\Http\Message\StreamInterface>, 'eventTime' => <DateTime>, 'id' => '<string>', 'processingStatus' => 'REQUESTED|PROCESSING|SUCCESS|FAILED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the lineage event was created.
- createdBy
-
- Type: string
The user who created the lineage event.
- domainId
-
- Type: string
The ID of the domain.
- event
-
- Type: blob (string|resource|Psr\Http\Message\StreamInterface)
The lineage event details.
- eventTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time of the lineage event.
- id
-
- Type: string
The ID of the lineage event.
- processingStatus
-
- Type: string
The progressing status of the lineage event.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetLineageNode
$result = $client->getLineageNode
([/* ... */]); $promise = $client->getLineageNodeAsync
([/* ... */]);
Gets the data lineage node.
Parameter Syntax
$result = $client->getLineageNode([ 'domainIdentifier' => '<string>', // REQUIRED 'eventTimestamp' => <integer || string || DateTime>, 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain in which you want to get the data lineage node.
- eventTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The event time stamp for which you want to get the data lineage node.
- identifier
-
- Required: Yes
- Type: string
The ID of the data lineage node that you want to get.
Both, a lineage node identifier generated by Amazon DataZone and a
sourceIdentifier
of the lineage node are supported. 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>', 'environmentDeploymentDetails' => [ 'environmentFailureReasons' => [ '<String>' => [ [ 'code' => '<string>', 'message' => '<string>', ], // ... ], // ... ], 'overallDeploymentStatus' => 'PENDING_DEPLOYMENT|IN_PROGRESS|SUCCESSFUL|FAILED_VALIDATION|FAILED_DEPLOYMENT', ], 'failureReasons' => [ [ 'code' => '<string>', 'message' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'projectProfileId' => '<string>', 'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED', 'userParameters' => [ [ 'environmentConfigurationName' => '<string>', 'environmentParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ], // ... ], ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the project.
- description
-
- Type: string
The description of the project.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the project exists.
- domainUnitId
-
- Type: string
The ID of the domain unit.
- environmentDeploymentDetails
-
- Type: EnvironmentDeploymentDetails structure
The environment deployment status of a project.
- failureReasons
-
- Type: Array of ProjectDeletionError structures
Specifies the error message that is returned if the operation cannot be successfully completed.
- glossaryTerms
-
- Type: Array of strings
The business glossary terms that can be used in the project.
- id
-
- Required: Yes
- Type: string
>The ID of the project.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project was last updated.
- name
-
- Required: Yes
- Type: string
The name of the project.
- projectProfileId
-
- Type: string
The ID of the project profile of a project.
- projectStatus
-
- Type: string
The status of the project.
- userParameters
-
- Type: Array of EnvironmentConfigurationUserParameter structures
The user parameters of a project.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetProjectProfile
$result = $client->getProjectProfile
([/* ... */]); $promise = $client->getProjectProfileAsync
([/* ... */]);
The details of the project profile.
Parameter Syntax
$result = $client->getProjectProfile([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain.
- identifier
-
- Required: Yes
- Type: string
The ID of the project profile.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentConfigurations' => [ [ 'awsAccount' => [ 'awsAccountId' => '<string>', 'awsAccountIdPath' => '<string>', ], 'awsRegion' => [ 'regionName' => '<string>', 'regionNamePath' => '<string>', ], 'configurationParameters' => [ 'parameterOverrides' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'resolvedParameters' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'ssmPath' => '<string>', ], 'deploymentMode' => 'ON_CREATE|ON_DEMAND', 'deploymentOrder' => <integer>, 'description' => '<string>', 'environmentBlueprintId' => '<string>', 'id' => '<string>', 'name' => '<string>', ], // ... ], 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'status' => 'ENABLED|DISABLED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project profile was created.
- createdBy
-
- Required: Yes
- Type: string
The user who created the project profile.
- description
-
- Type: string
The description of the project profile.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain of the project profile.
- domainUnitId
-
- Type: string
The ID of the domain unit of the project profile.
- environmentConfigurations
-
- Type: Array of EnvironmentConfiguration structures
The environment configurations of the project profile.
- id
-
- Required: Yes
- Type: string
The ID of the project profile.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when project profile was last updated.
- name
-
- Required: Yes
- Type: string
The name of the project profile.
- status
-
- Type: string
The status of the project profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetRule
$result = $client->getRule
([/* ... */]); $promise = $client->getRuleAsync
([/* ... */]);
Gets the details of a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.
Parameter Syntax
$result = $client->getRule([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'revision' => '<string>', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where the
GetRule
action is to be invoked. - identifier
-
- Required: Yes
- Type: string
The ID of the rule.
- revision
-
- Type: string
The revision of the rule.
Result Syntax
[ 'action' => 'CREATE_SUBSCRIPTION_REQUEST', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'detail' => [ 'metadataFormEnforcementDetail' => [ 'requiredMetadataForms' => [ [ 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], ], ], 'identifier' => '<string>', 'lastUpdatedBy' => '<string>', 'name' => '<string>', 'revision' => '<string>', 'ruleType' => 'METADATA_FORM_ENFORCEMENT', 'scope' => [ 'assetType' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificAssetTypes' => ['<string>', ...], ], 'dataProduct' => true || false, 'project' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificProjects' => ['<string>', ...], ], ], 'target' => [ 'domainUnitTarget' => [ 'domainUnitId' => '<string>', 'includeChildDomainUnits' => true || false, ], ], 'targetType' => 'DOMAIN_UNIT', 'updatedAt' => <DateTime>, ]
Result Details
Members
- action
-
- Required: Yes
- Type: string
The action of the rule.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the rule was created.
- createdBy
-
- Required: Yes
- Type: string
The user who created the rule.
- description
-
- Type: string
The description of the rule.
- detail
-
- Required: Yes
- Type: RuleDetail structure
The detail of the rule.
- identifier
-
- Required: Yes
- Type: string
The ID of the rule.
- lastUpdatedBy
-
- Required: Yes
- Type: string
The timestamp at which the rule was last updated.
- name
-
- Required: Yes
- Type: string
The name of the rule.
- revision
-
- Required: Yes
- Type: string
The revision of the rule.
- ruleType
-
- Required: Yes
- Type: string
The type of the rule.
- scope
-
- Required: Yes
- Type: RuleScope structure
The scope of the rule.
- target
-
- Required: Yes
- Type: RuleTarget structure
The target of the rule.
- targetType
-
- Type: string
The target type of the rule.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the rule was last updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetSubscription
$result = $client->getSubscription
([/* ... */]); $promise = $client->getSubscriptionAsync
([/* ... */]);
Gets a subscription in Amazon DataZone.
Parameter Syntax
$result = $client->getSubscription([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the subscription.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'retainPermissions' => true || false, 'status' => 'APPROVED|REVOKED|CANCELLED', 'subscribedListing' => [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], 'subscribedPrincipal' => [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], 'subscriptionRequestId' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription exists.
- id
-
- Required: Yes
- Type: string
The ID of the subscription.
- retainPermissions
-
- Type: boolean
The retain permissions of the subscription.
- status
-
- Required: Yes
- Type: string
The status of the subscription.
- subscribedListing
-
- Required: Yes
- Type: SubscribedListing structure
The details of the published asset for which the subscription grant is created.
- subscribedPrincipal
-
- Required: Yes
- Type: SubscribedPrincipal structure
The principal that owns the subscription.
- subscriptionRequestId
-
- Type: string
The ID of the subscription request.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetSubscriptionGrant
$result = $client->getSubscriptionGrant
([/* ... */]); $promise = $client->getSubscriptionGrantAsync
([/* ... */]);
Gets the subscription grant in Amazon DataZone.
Parameter Syntax
$result = $client->getSubscriptionGrant([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription grant exists.
- identifier
-
- Required: Yes
- Type: string
The ID of the subscription grant.
Result Syntax
[ 'assets' => [ [ 'assetId' => '<string>', 'assetRevision' => '<string>', 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'failureCause' => [ 'message' => '<string>', ], 'failureTimestamp' => <DateTime>, 'grantedTimestamp' => <DateTime>, 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED', 'targetName' => '<string>', ], // ... ], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'grantedEntity' => [ 'listing' => [ 'id' => '<string>', 'revision' => '<string>', ], ], 'id' => '<string>', 'status' => 'PENDING|IN_PROGRESS|GRANT_FAILED|REVOKE_FAILED|GRANT_AND_REVOKE_FAILED|COMPLETED|INACCESSIBLE', 'subscriptionId' => '<string>', 'subscriptionTargetId' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- assets
-
- Type: Array of SubscribedAsset structures
The assets for which the subscription grant is created.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription grant is created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription grant.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription grant exists.
- grantedEntity
-
- Required: Yes
- Type: GrantedEntity structure
The entity to which the subscription is granted.
- id
-
- Required: Yes
- Type: string
The ID of the subscription grant.
- status
-
- Required: Yes
- Type: string
The status of the subscription grant.
- subscriptionId
-
- Type: string
The identifier of the subscription.
- subscriptionTargetId
-
- Required: Yes
- Type: string
The subscription target ID associated with the subscription grant.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription grant was upated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription grant.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetSubscriptionRequestDetails
$result = $client->getSubscriptionRequestDetails
([/* ... */]); $promise = $client->getSubscriptionRequestDetailsAsync
([/* ... */]);
Gets the details of the specified subscription request.
Parameter Syntax
$result = $client->getSubscriptionRequestDetails([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which to get the subscription request details.
- identifier
-
- Required: Yes
- Type: string
The identifier of the subscription request the details of which to get.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'decisionComment' => '<string>', 'domainId' => '<string>', 'existingSubscriptionId' => '<string>', 'id' => '<string>', 'metadataForms' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', 'reviewerId' => '<string>', 'status' => 'PENDING|ACCEPTED|REJECTED', 'subscribedListings' => [ [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], // ... ], 'subscribedPrincipals' => [ [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], // ... ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the specified subscription request was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription request.
- decisionComment
-
- Type: string
The decision comment of the subscription request.
- domainId
-
- Required: Yes
- Type: string
The Amazon DataZone domain of the subscription request.
- existingSubscriptionId
-
- Type: string
The ID of the existing subscription.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription request.
- metadataForms
-
- Type: Array of FormOutput structures
The metadata forms included in the subscription request.
- requestReason
-
- Required: Yes
- Type: string
The reason for the subscription request.
- reviewerId
-
- Type: string
The identifier of the Amazon DataZone user who reviewed the subscription request.
- status
-
- Required: Yes
- Type: string
The status of the subscription request.
- subscribedListings
-
- Required: Yes
- Type: Array of SubscribedListing structures
The subscribed listings in the subscription request.
- subscribedPrincipals
-
- Required: Yes
- Type: Array of SubscribedPrincipal structures
The subscribed principals in the subscription request.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription request was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription request.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetSubscriptionTarget
$result = $client->getSubscriptionTarget
([/* ... */]); $promise = $client->getSubscriptionTargetAsync
([/* ... */]);
Gets the subscription target in Amazon DataZone.
Parameter Syntax
$result = $client->getSubscriptionTarget([ 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription target exists.
- environmentIdentifier
-
- Required: Yes
- Type: string
The ID of the environment associated with the subscription target.
- identifier
-
- Required: Yes
- Type: string
The ID of the subscription target.
Result Syntax
[ 'applicableAssetTypes' => ['<string>', ...], 'authorizedPrincipals' => ['<string>', ...], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'environmentId' => '<string>', 'id' => '<string>', 'manageAccessRole' => '<string>', 'name' => '<string>', 'projectId' => '<string>', 'provider' => '<string>', 'subscriptionTargetConfig' => [ [ 'content' => '<string>', 'formName' => '<string>', ], // ... ], 'type' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- applicableAssetTypes
-
- Required: Yes
- Type: Array of strings
The asset types associated with the subscription target.
- authorizedPrincipals
-
- Required: Yes
- Type: Array of strings
The authorized principals of the subscription target.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription target was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription target.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the subscription target exists.
- environmentId
-
- Required: Yes
- Type: string
The ID of the environment associated with the subscription target.
- id
-
- Required: Yes
- Type: string
The ID of the subscription target.
- manageAccessRole
-
- Type: string
The manage access role with which the subscription target was created.
- name
-
- Required: Yes
- Type: string
The name of the subscription target.
- projectId
-
- Required: Yes
- Type: string
The ID of the project associated with the subscription target.
- provider
-
- Required: Yes
- Type: string
The provider of the subscription target.
- subscriptionTargetConfig
-
- Required: Yes
- Type: Array of SubscriptionTargetForm structures
The configuration of teh subscription target.
- type
-
- Required: Yes
- Type: string
The type of the subscription target.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription target was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription target.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
GetTimeSeriesDataPoint
$result = $client->getTimeSeriesDataPoint
([/* ... */]); $promise = $client->getTimeSeriesDataPointAsync
([/* ... */]);
Gets the existing data point for the asset.
Parameter Syntax
$result = $client->getTimeSeriesDataPoint([ 'domainIdentifier' => '<string>', // REQUIRED 'entityIdentifier' => '<string>', // REQUIRED 'entityType' => 'ASSET|LISTING', // REQUIRED 'formName' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain that houses the asset for which you want to get the data point.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the asset for which you want to get the data point.
- entityType
-
- Required: Yes
- Type: string
The type of the asset for which you want to get the data point.
- formName
-
- Required: Yes
- Type: string
The name of the time series form that houses the data point that you want to get.
- identifier
-
- Required: Yes
- Type: string
The ID of the data point that you want to get.
Result Syntax
[ 'domainId' => '<string>', 'entityId' => '<string>', 'entityType' => 'ASSET|LISTING', 'form' => [ 'content' => '<string>', 'formName' => '<string>', 'id' => '<string>', 'timestamp' => <DateTime>, 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], 'formName' => '<string>', ]
Result Details
Members
- domainId
-
- Type: string
The ID of the Amazon DataZone domain that houses the asset data point that you want to get.
- entityId
-
- Type: string
The ID of the asset for which you want to get the data point.
- entityType
-
- Type: string
The type of the asset for which you want to get the data point.
- form
-
- 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.
ListConnections
$result = $client->listConnections
([/* ... */]); $promise = $client->listConnectionsAsync
([/* ... */]);
Lists connections. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.
Parameter Syntax
$result = $client->listConnections([ 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', 'maxResults' => <integer>, 'name' => '<string>', 'nextToken' => '<string>', 'projectIdentifier' => '<string>', // REQUIRED 'sortBy' => 'NAME', 'sortOrder' => 'ASCENDING|DESCENDING', 'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to list connections.
- environmentIdentifier
-
- Type: string
The ID of the environment where you want to list connections.
- maxResults
-
- Type: int
The maximum number of connections to return in a single call to ListConnections. When the number of connections to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListConnections to list the next set of connections.
- name
-
- Type: string
The name of the connection.
- nextToken
-
- Type: string
When the number of connections is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of connections, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListConnections to list the next set of connections.
- projectIdentifier
-
- Required: Yes
- Type: string
The ID of the project where you want to list connections.
- sortBy
-
- Type: string
Specifies how you want to sort the listed connections.
- sortOrder
-
- Type: string
Specifies the sort order for the listed connections.
- type
-
- Type: string
The type of connection.
Result Syntax
[ 'items' => [ [ 'connectionId' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentId' => '<string>', 'name' => '<string>', 'physicalEndpoints' => [ [ 'awsLocation' => [ 'accessRole' => '<string>', 'awsAccountId' => '<string>', 'awsRegion' => '<string>', 'iamConnectionId' => '<string>', ], 'glueConnection' => [ 'athenaProperties' => ['<string>', ...], 'authenticationConfiguration' => [ 'authenticationType' => 'BASIC|OAUTH2|CUSTOM', 'oAuth2Properties' => [ 'authorizationCodeProperties' => [ 'authorizationCode' => '<string>', 'redirectUri' => '<string>', ], 'oAuth2ClientApplication' => [ 'aWSManagedClientApplicationReference' => '<string>', 'userManagedClientApplicationClientId' => '<string>', ], 'oAuth2Credentials' => [ 'accessToken' => '<string>', 'jwtToken' => '<string>', 'refreshToken' => '<string>', 'userManagedClientApplicationClientSecret' => '<string>', ], 'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER', 'tokenUrl' => '<string>', 'tokenUrlParametersMap' => ['<string>', ...], ], 'secretArn' => '<string>', ], 'compatibleComputeEnvironments' => ['<string>', ...], 'connectionProperties' => ['<string>', ...], 'connectionSchemaVersion' => <integer>, 'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', 'creationTime' => <DateTime>, 'description' => '<string>', 'lastConnectionValidationTime' => <DateTime>, 'lastUpdatedBy' => '<string>', 'lastUpdatedTime' => <DateTime>, 'matchCriteria' => ['<string>', ...], 'name' => '<string>', 'physicalConnectionRequirements' => [ 'availabilityZone' => '<string>', 'securityGroupIdList' => ['<string>', ...], 'subnetId' => '<string>', 'subnetIdList' => ['<string>', ...], ], 'pythonProperties' => ['<string>', ...], 'sparkProperties' => ['<string>', ...], 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'statusReason' => '<string>', ], 'glueConnectionName' => '<string>', 'host' => '<string>', 'port' => <integer>, 'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM', 'stage' => '<string>', ], // ... ], 'projectId' => '<string>', 'props' => [ 'athenaProperties' => [ 'workgroupName' => '<string>', ], 'glueProperties' => [ 'errorMessage' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', ], 'hyperPodProperties' => [ 'clusterArn' => '<string>', 'clusterName' => '<string>', 'orchestrator' => 'EKS|SLURM', ], 'iamProperties' => [ 'environmentId' => '<string>', 'glueLineageSyncEnabled' => true || false, ], 'redshiftProperties' => [ 'credentials' => [ 'secretArn' => '<string>', 'usernamePassword' => [ 'password' => '<string>', 'username' => '<string>', ], ], 'databaseName' => '<string>', 'isProvisionedSecret' => true || false, 'jdbcIamUrl' => '<string>', 'jdbcUrl' => '<string>', 'lineageSync' => [ 'enabled' => true || false, 'lineageJobId' => '<string>', 'schedule' => [ 'schedule' => '<string>', ], ], 'redshiftTempDir' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'storage' => [ 'clusterName' => '<string>', 'workgroupName' => '<string>', ], ], 'sparkEmrProperties' => [ 'computeArn' => '<string>', 'credentials' => [ 'password' => '<string>', 'username' => '<string>', ], 'credentialsExpiration' => <DateTime>, 'governanceType' => 'AWS_MANAGED|USER_MANAGED', 'instanceProfileArn' => '<string>', 'javaVirtualEnv' => '<string>', 'livyEndpoint' => '<string>', 'logUri' => '<string>', 'pythonVirtualEnv' => '<string>', 'runtimeRole' => '<string>', 'trustedCertificatesS3Uri' => '<string>', ], 'sparkGlueProperties' => [ 'additionalArgs' => [ 'connection' => '<string>', ], 'glueConnectionName' => '<string>', 'glueVersion' => '<string>', 'idleTimeout' => <integer>, 'javaVirtualEnv' => '<string>', 'numberOfWorkers' => <integer>, 'pythonVirtualEnv' => '<string>', 'workerType' => '<string>', ], ], 'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Required: Yes
- Type: Array of ConnectionSummary structures
The results of the ListConnections action.
- nextToken
-
- Type: string
When the number of connections is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of connections, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListConnections to list the next set of connections.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
ListDataProductRevisions
$result = $client->listDataProductRevisions
([/* ... */]); $promise = $client->listDataProductRevisionsAsync
([/* ... */]);
Lists data product revisions.
Parameter Syntax
$result = $client->listDataProductRevisions([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain of the data product revisions that you want to list.
- identifier
-
- Required: Yes
- Type: string
The ID of the data product revision.
- maxResults
-
- Type: int
The maximum number of asset filters to return in a single call to
ListDataProductRevisions
. When the number of data product revisions to be listed is greater than the value 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', ], 'lineageSummary' => [ 'errorMessage' => '<string>', 'eventId' => '<string>', 'eventStatus' => 'REQUESTED|PROCESSING|SUCCESS|FAILED', ], 'projectId' => '<string>', 'technicalDescription' => '<string>', 'technicalName' => '<string>', 'updatedAt' => <DateTime>, ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Required: Yes
- Type: Array of DataSourceRunActivity structures
The results of the
ListDataSourceRunActivities
action. - nextToken
-
- Type: string
When the number of activities is greater than the default value for the
MaxResults
parameter, or if you explicitly specify a value 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>', 'lineageSummary' => [ 'importStatus' => 'IN_PROGRESS|SUCCESS|FAILED|PARTIALLY_SUCCEEDED', ], 'projectId' => '<string>', 'runStatisticsForAssets' => [ 'added' => <integer>, 'failed' => <integer>, 'skipped' => <integer>, 'unchanged' => <integer>, 'updated' => <integer>, ], 'startedAt' => <DateTime>, 'status' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS', 'stoppedAt' => <DateTime>, 'type' => 'PRIORITIZED|SCHEDULED', 'updatedAt' => <DateTime>, ], // ... ], '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([ 'connectionIdentifier' => '<string>', '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
- connectionIdentifier
-
- Type: string
The ID of the connection.
- 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' => [ [ 'connectionId' => '<string>', 'createdAt' => <DateTime>, 'dataSourceId' => '<string>', 'description' => '<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>', 'domainVersion' => 'V1|V2', '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>', 'environmentRolePermissionBoundary' => '<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.
ListJobRuns
$result = $client->listJobRuns
([/* ... */]); $promise = $client->listJobRunsAsync
([/* ... */]);
Lists job runs.
Parameter Syntax
$result = $client->listJobRuns([ 'domainIdentifier' => '<string>', // REQUIRED 'jobIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'sortOrder' => 'ASCENDING|DESCENDING', 'status' => 'SCHEDULED|IN_PROGRESS|SUCCESS|PARTIALLY_SUCCEEDED|FAILED|ABORTED|TIMED_OUT|CANCELED', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to list job runs.
- jobIdentifier
-
- Required: Yes
- Type: string
The ID of the job run.
- maxResults
-
- Type: int
The maximum number of job runs to return in a single call to ListJobRuns. When the number of job 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 ListJobRuns to list the next set of job runs.
- nextToken
-
- Type: string
When the number of job 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 job runs, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListJobRuns to list the next set of job runs.
- sortOrder
-
- Type: string
Specifies the order in which job runs are to be sorted.
- status
-
- Type: string
The status of a job run.
Result Syntax
[ 'items' => [ [ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'endTime' => <DateTime>, 'error' => [ 'message' => '<string>', ], 'jobId' => '<string>', 'jobType' => 'LINEAGE', 'runId' => '<string>', 'runMode' => 'SCHEDULED|ON_DEMAND', 'startTime' => <DateTime>, 'status' => 'SCHEDULED|IN_PROGRESS|SUCCESS|PARTIALLY_SUCCEEDED|FAILED|ABORTED|TIMED_OUT|CANCELED', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Type: Array of JobRunSummary structures
The results of the ListJobRuns action.
- nextToken
-
- Type: string
When the number of job 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 job runs, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListJobRuns to list the next set of job 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.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
ListLineageEvents
$result = $client->listLineageEvents
([/* ... */]); $promise = $client->listLineageEventsAsync
([/* ... */]);
Lists lineage events.
Parameter Syntax
$result = $client->listLineageEvents([ 'domainIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'processingStatus' => 'REQUESTED|PROCESSING|SUCCESS|FAILED', 'sortOrder' => 'ASCENDING|DESCENDING', 'timestampAfter' => <integer || string || DateTime>, 'timestampBefore' => <integer || string || DateTime>, ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to list lineage events.
- maxResults
-
- Type: int
The maximum number of lineage events to return in a single call to ListLineageEvents. When the number of lineage events 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 ListLineageEvents to list the next set of lineage events.
- nextToken
-
- Type: string
When the number of lineage events 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 lineage events, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListLineageEvents to list the next set of lineage events.
- processingStatus
-
- Type: string
The processing status of a lineage event.
- sortOrder
-
- Type: string
The sort order of the lineage events.
- timestampAfter
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The after timestamp of a lineage event.
- timestampBefore
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The before timestamp of a lineage event.
Result Syntax
[ 'items' => [ [ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'eventSummary' => [ 'openLineageRunEventSummary' => [ 'eventType' => 'START|RUNNING|COMPLETE|ABORT|FAIL|OTHER', 'inputs' => [ [ 'name' => '<string>', 'namespace' => '<string>', ], // ... ], 'job' => [ 'name' => '<string>', 'namespace' => '<string>', ], 'outputs' => [ [ 'name' => '<string>', 'namespace' => '<string>', ], // ... ], 'runId' => '<string>', ], ], 'eventTime' => <DateTime>, 'id' => '<string>', 'processingStatus' => 'REQUESTED|PROCESSING|SUCCESS|FAILED', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Type: Array of LineageEventSummary structures
The results of the ListLineageEvents action.
- nextToken
-
- Type: string
When the number of lineage events 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 lineage events, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListLineageEvents to list the next set of lineage events.
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|CREATE_ENVIRONMENT_FROM_BLUEPRINT|CREATE_PROJECT_FROM_PROJECT_PROFILE', // 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' => [ ], 'createEnvironmentFromBlueprint' => [ ], 'createEnvironmentProfile' => [ 'domainUnitId' => '<string>', ], 'createFormType' => [ 'includeChildDomainUnits' => true || false, ], 'createGlossary' => [ 'includeChildDomainUnits' => true || false, ], 'createProject' => [ 'includeChildDomainUnits' => true || false, ], 'createProjectFromProjectProfile' => [ 'includeChildDomainUnits' => true || false, 'projectProfiles' => ['<string>', ...], ], 'delegateCreateEnvironmentProfile' => [ ], 'overrideDomainUnitOwners' => [ 'includeChildDomainUnits' => true || false, ], 'overrideProjectOwners' => [ 'includeChildDomainUnits' => true || false, ], ], 'principal' => [ 'domainUnit' => [ 'domainUnitDesignation' => 'OWNER', 'domainUnitGrantFilter' => [ 'allDomainUnitsGrantFilter' => [ ], ], 'domainUnitIdentifier' => '<string>', ], 'group' => [ 'groupIdentifier' => '<string>', ], 'project' => [ 'projectDesignation' => 'OWNER|CONTRIBUTOR|PROJECT_CATALOG_STEWARD', '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|PROJECT_CATALOG_VIEWER|PROJECT_CATALOG_CONSUMER|PROJECT_CATALOG_STEWARD', '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.
ListProjectProfiles
$result = $client->listProjectProfiles
([/* ... */]); $promise = $client->listProjectProfilesAsync
([/* ... */]);
Lists project profiles.
Parameter Syntax
$result = $client->listProjectProfiles([ 'domainIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'name' => '<string>', 'nextToken' => '<string>', 'sortBy' => 'NAME', 'sortOrder' => 'ASCENDING|DESCENDING', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to list project profiles.
- maxResults
-
- Type: int
The maximum number of project profiles to return in a single call to ListProjectProfiles. When the number of project profiles to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListProjectProfiles to list the next set of project profiles.
- name
-
- Type: string
The name of a project profile.
- nextToken
-
- Type: string
When the number of project profiles is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of project profiles, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListProjectProfiles to list the next set of project profiles.
- sortBy
-
- Type: string
Specifies by what to sort project profiles.
- sortOrder
-
- Type: string
Specifies the sort order of the project profiles.
Result Syntax
[ 'items' => [ [ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'status' => 'ENABLED|DISABLED', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Type: Array of ProjectProfileSummary structures
The results of the ListProjectProfiles action.
- nextToken
-
- Type: string
When the number of project profiles is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of project profiles, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListProjectProfiles to list the next set of project 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.
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.
ListRules
$result = $client->listRules
([/* ... */]); $promise = $client->listRulesAsync
([/* ... */]);
Lists existing rules. In Amazon DataZone, a rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.
Parameter Syntax
$result = $client->listRules([ 'action' => 'CREATE_SUBSCRIPTION_REQUEST', 'assetTypes' => ['<string>', ...], 'dataProduct' => true || false, 'domainIdentifier' => '<string>', // REQUIRED 'includeCascaded' => true || false, 'maxResults' => <integer>, 'nextToken' => '<string>', 'projectIds' => ['<string>', ...], 'ruleType' => 'METADATA_FORM_ENFORCEMENT', 'targetIdentifier' => '<string>', // REQUIRED 'targetType' => 'DOMAIN_UNIT', // REQUIRED ]);
Parameter Details
Members
- action
-
- Type: string
The action of the rule.
- assetTypes
-
- Type: Array of strings
The asset types of the rule.
- dataProduct
-
- Type: boolean
The data product of the rule.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain in which the rules are to be listed.
- includeCascaded
-
- Type: boolean
Specifies whether to include cascading rules in the results.
- maxResults
-
- Type: int
The maximum number of rules to return in a single call to
ListRules
. When the number of rules to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListRules
to list the next set of rules. - nextToken
-
- Type: string
When the number of rules 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 rules, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListRules
to list the next set of rules. - projectIds
-
- Type: Array of strings
The IDs of projects in which rules are to be listed.
- ruleType
-
- Type: string
The type of the rule.
- targetIdentifier
-
- Required: Yes
- Type: string
The target ID of the rule.
- targetType
-
- Required: Yes
- Type: string
The target type of the rule.
Result Syntax
[ 'items' => [ [ 'action' => 'CREATE_SUBSCRIPTION_REQUEST', 'identifier' => '<string>', 'lastUpdatedBy' => '<string>', 'name' => '<string>', 'revision' => '<string>', 'ruleType' => 'METADATA_FORM_ENFORCEMENT', 'scope' => [ 'assetType' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificAssetTypes' => ['<string>', ...], ], 'dataProduct' => true || false, 'project' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificProjects' => ['<string>', ...], ], ], 'target' => [ 'domainUnitTarget' => [ 'domainUnitId' => '<string>', 'includeChildDomainUnits' => true || false, ], ], 'targetType' => 'DOMAIN_UNIT', 'updatedAt' => <DateTime>, ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Required: Yes
- Type: Array of RuleSummary structures
The results of the
ListRules
action. - nextToken
-
- Type: string
When the number of rules 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 rules, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListRules
to list the next set of rules.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
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>', 'existingSubscriptionId' => '<string>', 'id' => '<string>', 'metadataFormsSummary' => [ [ 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', 'reviewerId' => '<string>', 'status' => 'PENDING|ACCEPTED|REJECTED', 'subscribedListings' => [ [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], // ... ], 'subscribedPrincipals' => [ [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], // ... ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ], // ... ], '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
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.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
ListSubscriptions
$result = $client->listSubscriptions
([/* ... */]); $promise = $client->listSubscriptionsAsync
([/* ... */]);
Lists subscriptions in Amazon DataZone.
Parameter Syntax
$result = $client->listSubscriptions([ 'approverProjectId' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'owningProjectId' => '<string>', 'sortBy' => 'CREATED_AT|UPDATED_AT', 'sortOrder' => 'ASCENDING|DESCENDING', 'status' => 'APPROVED|REVOKED|CANCELLED', 'subscribedListingId' => '<string>', 'subscriptionRequestIdentifier' => '<string>', ]);
Parameter Details
Members
- approverProjectId
-
- Type: string
The identifier of the project for the subscription's approver.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- maxResults
-
- Type: int
The maximum number of subscriptions to return in a single call to
ListSubscriptions
. When the number of subscriptions to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListSubscriptions
to list the next set of Subscriptions. - nextToken
-
- Type: string
When the number of subscriptions 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 subscriptions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptions
to list the next set of subscriptions. - owningProjectId
-
- Type: string
The identifier of the owning project.
- 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.
- status
-
- Type: string
The status of the subscriptions that you want to list.
This is not a required parameter, but if not provided, by default, Amazon DataZone returns only
APPROVED
subscriptions. - subscribedListingId
-
- Type: string
The identifier of the subscribed listing for the subscriptions that you want to list.
- subscriptionRequestIdentifier
-
- Type: string
The identifier of the subscription request for the subscriptions that you want to list.
Result Syntax
[ 'items' => [ [ '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>', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Required: Yes
- Type: Array of SubscriptionSummary structures
The results of the
ListSubscriptions
action. - nextToken
-
- Type: string
When the number of subscriptions 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 subscriptions, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListSubscriptions
to list the next set of subscriptions.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Lists tags for the specified resource in Amazon DataZone.
Parameter Syntax
$result = $client->listTagsForResource([ 'resourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The ARN of the resource whose tags you want to list.
Result Syntax
[ 'tags' => ['<string>', ...], ]
Result Details
Members
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags of the specified resource.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
ListTimeSeriesDataPoints
$result = $client->listTimeSeriesDataPoints
([/* ... */]); $promise = $client->listTimeSeriesDataPointsAsync
([/* ... */]);
Lists time series data points.
Parameter Syntax
$result = $client->listTimeSeriesDataPoints([ 'domainIdentifier' => '<string>', // REQUIRED 'endedAt' => <integer || string || DateTime>, 'entityIdentifier' => '<string>', // REQUIRED 'entityType' => 'ASSET|LISTING', // REQUIRED 'formName' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'startedAt' => <integer || string || DateTime>, ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain that houses the assets for which you want to list time series data points.
- endedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data points that you wanted to list ended.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the asset for which you want to list data points.
- entityType
-
- Required: Yes
- Type: string
The type of the asset for which you want to list data points.
- formName
-
- Required: Yes
- Type: string
The name of the time series data points form.
- maxResults
-
- Type: int
The maximum number of data points to return in a single call to ListTimeSeriesDataPoints. When the number of data points 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 ListTimeSeriesDataPoints to list the next set of data points.
- nextToken
-
- Type: string
When the number of data points is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of data points, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListTimeSeriesDataPoints to list the next set of data points.
- startedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data points that you want to list started.
Result Syntax
[ 'items' => [ [ 'contentSummary' => '<string>', 'formName' => '<string>', 'id' => '<string>', 'timestamp' => <DateTime>, 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Type: Array of TimeSeriesDataPointSummaryFormOutput structures
The results of the ListTimeSeriesDataPoints action.
- nextToken
-
- Type: string
When the number of data points is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of data points, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListTimeSeriesDataPoints to list the next set of data points.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
PostLineageEvent
$result = $client->postLineageEvent
([/* ... */]); $promise = $client->postLineageEventAsync
([/* ... */]);
Posts a data lineage event.
Parameter Syntax
$result = $client->postLineageEvent([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'event' => <string || resource || Psr\Http\Message\StreamInterface>, // 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 where you want to post a data lineage event.
- event
-
- Required: Yes
- Type: blob (string|resource|Psr\Http\Message\StreamInterface)
The data lineage event that you want to post. Only open-lineage run event are supported as events.
Result Syntax
[ 'domainId' => '<string>', 'id' => '<string>', ]
Result Details
Members
- domainId
-
- Type: string
The ID of the domain.
- id
-
- Type: string
The ID of the lineage event.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- 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.
PostTimeSeriesDataPoints
$result = $client->postTimeSeriesDataPoints
([/* ... */]); $promise = $client->postTimeSeriesDataPointsAsync
([/* ... */]);
Posts time series data points to Amazon DataZone for the specified asset.
Parameter Syntax
$result = $client->postTimeSeriesDataPoints([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'entityIdentifier' => '<string>', // REQUIRED 'entityType' => 'ASSET|LISTING', // REQUIRED 'forms' => [ // REQUIRED [ 'content' => '<string>', 'formName' => '<string>', // REQUIRED 'timestamp' => <integer || string || DateTime>, // REQUIRED '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.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which you want to post time series data points.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the asset for which you want to post time series data points.
- entityType
-
- Required: Yes
- Type: string
The type of the asset for which you want to post data points.
- forms
-
- Required: Yes
- Type: Array of TimeSeriesDataPointFormInput structures
The forms that contain the data points that you want to post.
Result Syntax
[ 'domainId' => '<string>', 'entityId' => '<string>', 'entityType' => 'ASSET|LISTING', 'forms' => [ [ 'content' => '<string>', 'formName' => '<string>', 'id' => '<string>', 'timestamp' => <DateTime>, 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], ]
Result Details
Members
- domainId
-
- Type: string
The ID of the Amazon DataZone domain in which you want to post time series data points.
- entityId
-
- Type: string
The ID of the asset for which you want to post time series data points.
- entityType
-
- Type: string
The type of the asset for which you want to post data points.
- forms
-
- Type: Array of TimeSeriesDataPointFormOutput structures
The forms that contain the data points that you have posted.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
PutEnvironmentBlueprintConfiguration
$result = $client->putEnvironmentBlueprintConfiguration
([/* ... */]); $promise = $client->putEnvironmentBlueprintConfigurationAsync
([/* ... */]);
Writes the configuration for the specified environment blueprint in Amazon DataZone.
Parameter Syntax
$result = $client->putEnvironmentBlueprintConfiguration([ 'domainIdentifier' => '<string>', // REQUIRED 'enabledRegions' => ['<string>', ...], // REQUIRED 'environmentBlueprintIdentifier' => '<string>', // REQUIRED 'environmentRolePermissionBoundary' => '<string>', 'manageAccessRoleArn' => '<string>', 'provisioningConfigurations' => [ [ 'lakeFormationConfiguration' => [ 'locationRegistrationExcludeS3Locations' => ['<string>', ...], 'locationRegistrationRole' => '<string>', ], ], // ... ], 'provisioningRoleArn' => '<string>', 'regionalParameters' => [ '<RegionName>' => ['<string>', ...], // ... ], ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- enabledRegions
-
- Required: Yes
- Type: Array of strings
Specifies the enabled Amazon Web Services Regions.
- environmentBlueprintIdentifier
-
- Required: Yes
- Type: string
The identifier of the environment blueprint.
- environmentRolePermissionBoundary
-
- Type: string
The environment role permissions boundary.
- manageAccessRoleArn
-
- Type: string
The ARN of the manage access role.
- provisioningConfigurations
-
- Type: Array of ProvisioningConfiguration structures
The provisioning configuration of a blueprint.
- provisioningRoleArn
-
- Type: string
The ARN of the provisioning role.
- regionalParameters
-
- Type: Associative array of custom strings keys (RegionName) to stringss
The regional parameters in the environment blueprint.
Result Syntax
[ 'createdAt' => <DateTime>, 'domainId' => '<string>', 'enabledRegions' => ['<string>', ...], 'environmentBlueprintId' => '<string>', 'environmentRolePermissionBoundary' => '<string>', 'manageAccessRoleArn' => '<string>', 'provisioningConfigurations' => [ [ 'lakeFormationConfiguration' => [ 'locationRegistrationExcludeS3Locations' => ['<string>', ...], 'locationRegistrationRole' => '<string>', ], ], // ... ], 'provisioningRoleArn' => '<string>', 'regionalParameters' => [ '<RegionName>' => ['<string>', ...], // ... ], 'updatedAt' => <DateTime>, ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment blueprint was created.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- enabledRegions
-
- Type: Array of strings
Specifies the enabled Amazon Web Services Regions.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The identifier of the environment blueprint.
- environmentRolePermissionBoundary
-
- Type: string
The environment role permissions boundary.
- manageAccessRoleArn
-
- Type: string
The ARN of the manage access role.
- provisioningConfigurations
-
- Type: Array of ProvisioningConfiguration structures
The provisioning configuration of a blueprint.
- provisioningRoleArn
-
- Type: string
The ARN of the provisioning role.
- regionalParameters
-
- Type: Associative array of custom strings keys (RegionName) to stringss
The regional parameters in the environment blueprint.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment blueprint 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.
- 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.
RejectPredictions
$result = $client->rejectPredictions
([/* ... */]); $promise = $client->rejectPredictionsAsync
([/* ... */]);
Rejects automatically generated business-friendly metadata for your Amazon DataZone assets.
Parameter Syntax
$result = $client->rejectPredictions([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'rejectChoices' => [ [ 'predictionChoices' => [<integer>, ...], 'predictionTarget' => '<string>', // REQUIRED ], // ... ], 'rejectRule' => [ 'rule' => 'ALL|NONE', 'threshold' => <float>, ], 'revision' => '<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 identifier of the Amazon DataZone domain.
- identifier
-
- Required: Yes
- Type: string
The identifier of the prediction.
- rejectChoices
-
- Type: Array of RejectChoice structures
Specifies the prediction (aka, the automatically generated piece of metadata) and the target (for example, a column name) that can be rejected.
- rejectRule
-
- Type: RejectRule structure
Specifies the rule (or the conditions) under which a prediction can be rejected.
- revision
-
- Type: string
The revision that is to be made to the asset.
Result Syntax
[ 'assetId' => '<string>', 'assetRevision' => '<string>', 'domainId' => '<string>', ]
Result Details
Members
- assetId
-
- Required: Yes
- Type: string
The ID of the asset.
- assetRevision
-
- Required: Yes
- Type: string
The revision that is to be made to the asset.
- domainId
-
- Required: Yes
- Type: string
The ID of 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.
- 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.
RejectSubscriptionRequest
$result = $client->rejectSubscriptionRequest
([/* ... */]); $promise = $client->rejectSubscriptionRequestAsync
([/* ... */]);
Rejects the specified subscription request.
Parameter Syntax
$result = $client->rejectSubscriptionRequest([ 'decisionComment' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- decisionComment
-
- Type: string
The decision comment of the rejected subscription request.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the subscription request was rejected.
- identifier
-
- Required: Yes
- Type: string
The identifier of the subscription request that was rejected.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'decisionComment' => '<string>', 'domainId' => '<string>', 'existingSubscriptionId' => '<string>', 'id' => '<string>', 'metadataForms' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', 'reviewerId' => '<string>', 'status' => 'PENDING|ACCEPTED|REJECTED', 'subscribedListings' => [ [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], // ... ], 'subscribedPrincipals' => [ [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], // ... ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription request was rejected.
- createdBy
-
- Required: Yes
- Type: string
The timestamp of when the subscription request was rejected.
- decisionComment
-
- Type: string
The decision comment of the rejected subscription request.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the subscription request was rejected.
- existingSubscriptionId
-
- Type: string
The ID of the existing subscription.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription request that was rejected.
- metadataForms
-
- Type: Array of FormOutput structures
Metadata forms included in the subscription request.
- requestReason
-
- Required: Yes
- Type: string
The reason for the subscription request.
- reviewerId
-
- Type: string
The identifier of the subscription request reviewer.
- status
-
- Required: Yes
- Type: string
The status of the subscription request.
- subscribedListings
-
- Required: Yes
- Type: Array of SubscribedListing structures
The subscribed listings of the subscription request.
- 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.
RemoveEntityOwner
$result = $client->removeEntityOwner
([/* ... */]); $promise = $client->removeEntityOwnerAsync
([/* ... */]);
Removes an owner from an entity.
Parameter Syntax
$result = $client->removeEntityOwner([ '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 where you want to remove an owner from an entity.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the entity from which you want to remove an owner.
- entityType
-
- Required: Yes
- Type: string
The type of the entity from which you want to remove an owner.
- owner
-
- Required: Yes
- Type: OwnerProperties structure
The owner that you want to remove from an 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.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
RemovePolicyGrant
$result = $client->removePolicyGrant
([/* ... */]); $promise = $client->removePolicyGrantAsync
([/* ... */]);
Removes a policy grant.
Parameter Syntax
$result = $client->removePolicyGrant([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'entityIdentifier' => '<string>', // REQUIRED 'entityType' => 'DOMAIN_UNIT|ENVIRONMENT_BLUEPRINT_CONFIGURATION|ENVIRONMENT_PROFILE', // REQUIRED 'policyType' => 'CREATE_DOMAIN_UNIT|OVERRIDE_DOMAIN_UNIT_OWNERS|ADD_TO_PROJECT_MEMBER_POOL|OVERRIDE_PROJECT_OWNERS|CREATE_GLOSSARY|CREATE_FORM_TYPE|CREATE_ASSET_TYPE|CREATE_PROJECT|CREATE_ENVIRONMENT_PROFILE|DELEGATE_CREATE_ENVIRONMENT_PROFILE|CREATE_ENVIRONMENT|CREATE_ENVIRONMENT_FROM_BLUEPRINT|CREATE_PROJECT_FROM_PROJECT_PROFILE', // REQUIRED 'principal' => [ // REQUIRED 'domainUnit' => [ 'domainUnitDesignation' => 'OWNER', // REQUIRED 'domainUnitGrantFilter' => [ 'allDomainUnitsGrantFilter' => [ ], ], 'domainUnitIdentifier' => '<string>', ], 'group' => [ 'groupIdentifier' => '<string>', ], 'project' => [ 'projectDesignation' => 'OWNER|CONTRIBUTOR|PROJECT_CATALOG_STEWARD', // REQUIRED 'projectGrantFilter' => [ 'domainUnitFilter' => [ 'domainUnit' => '<string>', // REQUIRED 'includeChildDomainUnits' => true || false, ], ], 'projectIdentifier' => '<string>', ], 'user' => [ 'allUsersGrantFilter' => [ ], 'userIdentifier' => '<string>', ], ], ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to remove a policy grant.
- entityIdentifier
-
- Required: Yes
- Type: string
The ID of the entity from which you want to remove a policy grant.
- entityType
-
- Required: Yes
- Type: string
The type of the entity from which you want to remove a policy grant.
- policyType
-
- Required: Yes
- Type: string
The type of the policy that you want to remove.
- principal
-
- Required: Yes
- Type: PolicyGrantPrincipal structure
The principal from which you want to remove a policy grant.
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.
RevokeSubscription
$result = $client->revokeSubscription
([/* ... */]); $promise = $client->revokeSubscriptionAsync
([/* ... */]);
Revokes a specified subscription in Amazon DataZone.
Parameter Syntax
$result = $client->revokeSubscription([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'retainPermissions' => true || false, ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain where you want to revoke a subscription.
- identifier
-
- Required: Yes
- Type: string
The identifier of the revoked subscription.
- retainPermissions
-
- Type: boolean
Specifies whether permissions are retained when the subscription is revoked.
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 revoked.
- createdBy
-
- Required: Yes
- Type: string
The identifier of the user who revoked the subscription.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain where you want to revoke a subscription.
- id
-
- Required: Yes
- Type: string
The identifier of the revoked subscription.
- retainPermissions
-
- Type: boolean
Specifies whether permissions are retained when the subscription is revoked.
- status
-
- Required: Yes
- Type: string
The status of the revoked subscription.
- subscribedListing
-
- Required: Yes
- Type: SubscribedListing structure
The subscribed listing of the revoked subscription.
- subscribedPrincipal
-
- Required: Yes
- Type: SubscribedPrincipal structure
The subscribed principal of the revoked subscription.
- subscriptionRequestId
-
- Type: string
The identifier of the subscription request for the revoked subscription.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription was revoked.
- updatedBy
-
- Type: string
The Amazon DataZone user who revoked 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.
Search
$result = $client->search
([/* ... */]); $promise = $client->searchAsync
([/* ... */]);
Searches for assets in Amazon DataZone.
Parameter Syntax
$result = $client->search([ 'additionalAttributes' => ['<string>', ...], 'domainIdentifier' => '<string>', // REQUIRED 'filters' => [ 'and' => [ [...], // RECURSIVE // ... ], 'filter' => [ 'attribute' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], 'or' => [ [...], // RECURSIVE // ... ], ], 'maxResults' => <integer>, 'nextToken' => '<string>', 'owningProjectIdentifier' => '<string>', 'searchIn' => [ [ 'attribute' => '<string>', // REQUIRED ], // ... ], 'searchScope' => 'ASSET|GLOSSARY|GLOSSARY_TERM|DATA_PRODUCT', // REQUIRED 'searchText' => '<string>', 'sort' => [ 'attribute' => '<string>', // REQUIRED 'order' => 'ASCENDING|DESCENDING', ], ]);
Parameter Details
Members
- additionalAttributes
-
- Type: Array of strings
Specifies additional attributes for the
Search
action. - domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- filters
-
- Type: FilterClause structure
Specifies the search filters.
- maxResults
-
- Type: int
The maximum number of results to return in a single call to
Search
. When the number of results to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toSearch
to list the next set of results. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearch
to list the next set of results. - owningProjectIdentifier
-
- Type: string
The identifier of the owning project specified for the search.
- searchIn
-
- Type: Array of SearchInItem structures
The details of the search.
- searchScope
-
- Required: Yes
- Type: string
The scope of the search.
- searchText
-
- Type: string
Specifies the text for which to search.
- sort
-
- Type: SearchSort structure
Specifies the way in which the search results are to be sorted.
Result Syntax
[ 'items' => [ [ 'assetItem' => [ 'additionalAttributes' => [ 'formsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'latestTimeSeriesDataPointFormsOutput' => [ [ 'contentSummary' => '<string>', 'formName' => '<string>', 'id' => '<string>', 'timestamp' => <DateTime>, 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'readOnlyFormsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], ], 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'externalIdentifier' => '<string>', 'firstRevisionCreatedAt' => <DateTime>, 'firstRevisionCreatedBy' => '<string>', 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], 'dataProductItem' => [ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'firstRevisionCreatedAt' => <DateTime>, 'firstRevisionCreatedBy' => '<string>', 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', ], 'glossaryItem' => [ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', 'status' => 'DISABLED|ENABLED', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ], 'glossaryTermItem' => [ '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>', ], ], // ... ], 'nextToken' => '<string>', 'totalMatchCount' => <integer>, ]
Result Details
Members
- items
-
- Type: Array of SearchInventoryResultItem structures
The results of the
Search
action. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearch
to list the next set of results. - totalMatchCount
-
- Type: int
Total number of search results.
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.
SearchGroupProfiles
$result = $client->searchGroupProfiles
([/* ... */]); $promise = $client->searchGroupProfilesAsync
([/* ... */]);
Searches group profiles in Amazon DataZone.
Parameter Syntax
$result = $client->searchGroupProfiles([ 'domainIdentifier' => '<string>', // REQUIRED 'groupType' => 'SSO_GROUP|DATAZONE_SSO_GROUP', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchText' => '<string>', ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which you want to search group profiles.
- groupType
-
- Required: Yes
- Type: string
The group type for which to search.
- maxResults
-
- Type: int
The maximum number of results to return in a single call to
SearchGroupProfiles
. When the number of results to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toSearchGroupProfiles
to list the next set of results. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchGroupProfiles
to list the next set of results. - searchText
-
- Type: string
Specifies the text for which to search.
Result Syntax
[ 'items' => [ [ 'domainId' => '<string>', 'groupName' => '<string>', 'id' => '<string>', 'status' => 'ASSIGNED|NOT_ASSIGNED', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Type: Array of GroupProfileSummary structures
The results of the
SearchGroupProfiles
action. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchGroupProfiles
to list the next set of results.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
SearchListings
$result = $client->searchListings
([/* ... */]); $promise = $client->searchListingsAsync
([/* ... */]);
Searches listings (records of an asset at a given time) in Amazon DataZone.
Parameter Syntax
$result = $client->searchListings([ 'additionalAttributes' => ['<string>', ...], 'domainIdentifier' => '<string>', // REQUIRED 'filters' => [ 'and' => [ [...], // RECURSIVE // ... ], 'filter' => [ 'attribute' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], 'or' => [ [...], // RECURSIVE // ... ], ], 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchIn' => [ [ 'attribute' => '<string>', // REQUIRED ], // ... ], 'searchText' => '<string>', 'sort' => [ 'attribute' => '<string>', // REQUIRED 'order' => 'ASCENDING|DESCENDING', ], ]);
Parameter Details
Members
- additionalAttributes
-
- Type: Array of strings
Specifies additional attributes for the search.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the domain in which to search listings.
- filters
-
- Type: FilterClause structure
Specifies the filters for the search of listings.
- maxResults
-
- Type: int
The maximum number of results to return in a single call to
SearchListings
. When the number of results to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toSearchListings
to list the next set of results. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchListings
to list the next set of results. - searchIn
-
- Type: Array of SearchInItem structures
The details of the search.
- searchText
-
- Type: string
Specifies the text for which to search.
- sort
-
- Type: SearchSort structure
Specifies the way for sorting the search results.
Result Syntax
[ 'items' => [ [ 'assetListing' => [ 'additionalAttributes' => [ 'forms' => '<string>', 'latestTimeSeriesDataPointForms' => [ [ 'contentSummary' => '<string>', 'formName' => '<string>', 'id' => '<string>', 'timestamp' => <DateTime>, 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], ], 'createdAt' => <DateTime>, 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'listingCreatedBy' => '<string>', 'listingId' => '<string>', 'listingRevision' => '<string>', 'listingUpdatedBy' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', ], 'dataProductListing' => [ 'additionalAttributes' => [ 'forms' => '<string>', ], 'createdAt' => <DateTime>, 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'items' => [ [ 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'listingId' => '<string>', 'listingRevision' => '<string>', ], // ... ], 'listingCreatedBy' => '<string>', 'listingId' => '<string>', 'listingRevision' => '<string>', 'listingUpdatedBy' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', ], ], // ... ], 'nextToken' => '<string>', 'totalMatchCount' => <integer>, ]
Result Details
Members
- items
-
- Type: Array of SearchResultItem structures
The results of the
SearchListings
action. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchListings
to list the next set of results. - totalMatchCount
-
- Type: int
Total number of search results.
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.
SearchTypes
$result = $client->searchTypes
([/* ... */]); $promise = $client->searchTypesAsync
([/* ... */]);
Searches for types in Amazon DataZone.
Parameter Syntax
$result = $client->searchTypes([ 'domainIdentifier' => '<string>', // REQUIRED 'filters' => [ 'and' => [ [...], // RECURSIVE // ... ], 'filter' => [ 'attribute' => '<string>', // REQUIRED 'value' => '<string>', // REQUIRED ], 'or' => [ [...], // RECURSIVE // ... ], ], 'managed' => true || false, // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchIn' => [ [ 'attribute' => '<string>', // REQUIRED ], // ... ], 'searchScope' => 'ASSET_TYPE|FORM_TYPE|LINEAGE_NODE_TYPE', // REQUIRED 'searchText' => '<string>', 'sort' => [ 'attribute' => '<string>', // REQUIRED 'order' => 'ASCENDING|DESCENDING', ], ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which to invoke the
SearchTypes
action. - filters
-
- Type: FilterClause structure
The filters for the
SearchTypes
action. - managed
-
- Required: Yes
- Type: boolean
Specifies whether the search is managed.
- maxResults
-
- Type: int
The maximum number of results to return in a single call to
SearchTypes
. When the number of results to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toSearchTypes
to list the next set of results. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchTypes
to list the next set of results. - searchIn
-
- Type: Array of SearchInItem structures
The details of the search.
- searchScope
-
- Required: Yes
- Type: string
Specifies the scope of the search for types.
- searchText
-
- Type: string
Specifies the text for which to search.
- sort
-
- Type: SearchSort structure
The specifies the way to sort the
SearchTypes
results.
Result Syntax
[ 'items' => [ [ 'assetTypeItem' => [ '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>', ], 'formTypeItem' => [ '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', ], 'lineageNodeTypeItem' => [ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'formsOutput' => [ '<FormName>' => [ 'required' => true || false, 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'name' => '<string>', 'revision' => '<string>', 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ], ], // ... ], 'nextToken' => '<string>', 'totalMatchCount' => <integer>, ]
Result Details
Members
- items
-
- Type: Array of SearchTypesResultItem structures
The results of the
SearchTypes
action. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchTypes
to list the next set of results. - totalMatchCount
-
- Type: int
Total number of search results.
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.
SearchUserProfiles
$result = $client->searchUserProfiles
([/* ... */]); $promise = $client->searchUserProfilesAsync
([/* ... */]);
Searches user profiles in Amazon DataZone.
Parameter Syntax
$result = $client->searchUserProfiles([ 'domainIdentifier' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchText' => '<string>', 'userType' => 'SSO_USER|DATAZONE_USER|DATAZONE_SSO_USER|DATAZONE_IAM_USER', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which you want to search user profiles.
- maxResults
-
- Type: int
The maximum number of results to return in a single call to
SearchUserProfiles
. When the number of results to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toSearchUserProfiles
to list the next set of results. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchUserProfiles
to list the next set of results. - searchText
-
- Type: string
Specifies the text for which to search.
- userType
-
- Required: Yes
- Type: string
Specifies the user type for the
SearchUserProfiles
action.
Result Syntax
[ 'items' => [ [ 'details' => [ 'iam' => [ 'arn' => '<string>', ], 'sso' => [ 'firstName' => '<string>', 'lastName' => '<string>', 'username' => '<string>', ], ], 'domainId' => '<string>', 'id' => '<string>', 'status' => 'ASSIGNED|NOT_ASSIGNED|ACTIVATED|DEACTIVATED', 'type' => 'IAM|SSO', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- items
-
- Type: Array of UserProfileSummary structures
The results of the
SearchUserProfiles
action. - nextToken
-
- Type: string
When the number of results 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 results, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toSearchUserProfiles
to list the next set of results.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified 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.
StartDataSourceRun
$result = $client->startDataSourceRun
([/* ... */]); $promise = $client->startDataSourceRunAsync
([/* ... */]);
Start the run of the specified data source in Amazon DataZone.
Parameter Syntax
$result = $client->startDataSourceRun([ 'clientToken' => '<string>', 'dataSourceIdentifier' => '<string>', // REQUIRED 'domainIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: string
A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.
- 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 start a 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 data source run was created.
- dataSourceConfigurationSnapshot
-
- Type: string
The configuration snapshot of the data source that is being run.
- dataSourceId
-
- Required: Yes
- Type: string
The identifier of the data source.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which to start a data source run.
- errorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The identifier of the data source run.
- projectId
-
- Required: Yes
- Type: string
The identifier of the project.
- runStatisticsForAssets
-
- Type: RunStatisticsForAssets structure
Specifies run statistics for assets.
- startedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source run was started.
- status
-
- Required: Yes
- Type: string
The status of the data source run.
- stoppedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source run was stopped.
- type
-
- Required: Yes
- Type: string
The type of the data source run.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the 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.
StartMetadataGenerationRun
$result = $client->startMetadataGenerationRun
([/* ... */]); $promise = $client->startMetadataGenerationRunAsync
([/* ... */]);
Starts the metadata generation run.
Parameter Syntax
$result = $client->startMetadataGenerationRun([ 'clientToken' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'owningProjectIdentifier' => '<string>', // REQUIRED 'target' => [ // REQUIRED 'identifier' => '<string>', // REQUIRED 'revision' => '<string>', 'type' => 'ASSET', // REQUIRED ], 'type' => 'BUSINESS_DESCRIPTIONS', // 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 where you want to start a metadata generation run.
- owningProjectIdentifier
-
- Required: Yes
- Type: string
The ID of the project that owns the asset for which you want to start a metadata generation run.
- target
-
- Required: Yes
- Type: MetadataGenerationRunTarget structure
The asset for which you want to start a metadata generation run.
- type
-
- Required: Yes
- Type: string
The type of the metadata generation run.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'owningProjectId' => '<string>', 'status' => 'SUBMITTED|IN_PROGRESS|CANCELED|SUCCEEDED|FAILED', 'type' => 'BUSINESS_DESCRIPTIONS', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the metadata generation run was started.
- createdBy
-
- Type: string
The ID of the user who started the metadata generation run.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the metadata generation run was started.
- id
-
- Required: Yes
- Type: string
The ID of the metadata generation run.
- owningProjectId
-
- Type: string
The ID of the project that owns the asset for which the metadata generation run was started.
- status
-
- Type: string
The status of the metadata generation run.
- type
-
- Type: string
The type of the 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.
- 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.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Tags a resource in Amazon DataZone.
Parameter Syntax
$result = $client->tagResource([ 'resourceArn' => '<string>', // REQUIRED 'tags' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The ARN of the resource to be tagged in Amazon DataZone.
- tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
Specifies the tags for the
TagResource
action.
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.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Untags a resource in Amazon DataZone.
Parameter Syntax
$result = $client->untagResource([ 'resourceArn' => '<string>', // REQUIRED 'tagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The ARN of the resource to be untagged in Amazon DataZone.
- tagKeys
-
- Required: Yes
- Type: Array of strings
Specifies the tag keys for the
UntagResource
action.
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.
- UnauthorizedException:
You do not have permission to perform this action.
UpdateAssetFilter
$result = $client->updateAssetFilter
([/* ... */]); $promise = $client->updateAssetFilterAsync
([/* ... */]);
Updates an asset filter.
Parameter Syntax
$result = $client->updateAssetFilter([ 'assetIdentifier' => '<string>', // REQUIRED 'configuration' => [ '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 'identifier' => '<string>', // REQUIRED 'name' => '<string>', ]);
Parameter Details
Members
- assetIdentifier
-
- Required: Yes
- Type: string
The ID of the data asset.
- configuration
-
- 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 where you want to update an asset filter.
- identifier
-
- Required: Yes
- Type: string
The ID of the asset filter.
- name
-
- 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 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 the asset filter was created.
- 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 is not completed 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.
- 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.
UpdateConnection
$result = $client->updateConnection
([/* ... */]); $promise = $client->updateConnectionAsync
([/* ... */]);
Updates a connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.
Parameter Syntax
$result = $client->updateConnection([ 'awsLocation' => [ 'accessRole' => '<string>', 'awsAccountId' => '<string>', 'awsRegion' => '<string>', 'iamConnectionId' => '<string>', ], 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'props' => [ 'athenaProperties' => [ 'workgroupName' => '<string>', ], 'glueProperties' => [ 'glueConnectionInput' => [ 'authenticationConfiguration' => [ 'basicAuthenticationCredentials' => [ 'password' => '<string>', 'userName' => '<string>', ], 'secretArn' => '<string>', ], 'connectionProperties' => ['<string>', ...], 'description' => '<string>', ], ], 'iamProperties' => [ 'glueLineageSyncEnabled' => true || false, ], 'redshiftProperties' => [ 'credentials' => [ 'secretArn' => '<string>', 'usernamePassword' => [ 'password' => '<string>', // REQUIRED 'username' => '<string>', // REQUIRED ], ], 'databaseName' => '<string>', 'host' => '<string>', 'lineageSync' => [ 'enabled' => true || false, 'schedule' => [ 'schedule' => '<string>', ], ], 'port' => <integer>, 'storage' => [ 'clusterName' => '<string>', 'workgroupName' => '<string>', ], ], 'sparkEmrProperties' => [ 'computeArn' => '<string>', 'instanceProfileArn' => '<string>', 'javaVirtualEnv' => '<string>', 'logUri' => '<string>', 'pythonVirtualEnv' => '<string>', 'runtimeRole' => '<string>', 'trustedCertificatesS3Uri' => '<string>', ], ], ]);
Parameter Details
Members
- awsLocation
-
- Type: AwsLocation structure
The location where a connection is to be updated.
- description
-
- Type: string
The description of a connection.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where a connection is to be updated.
- identifier
-
- Required: Yes
- Type: string
The ID of the connection to be updated.
- props
-
- Type: ConnectionPropertiesPatch structure
The connection props.
Result Syntax
[ 'connectionId' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentId' => '<string>', 'name' => '<string>', 'physicalEndpoints' => [ [ 'awsLocation' => [ 'accessRole' => '<string>', 'awsAccountId' => '<string>', 'awsRegion' => '<string>', 'iamConnectionId' => '<string>', ], 'glueConnection' => [ 'athenaProperties' => ['<string>', ...], 'authenticationConfiguration' => [ 'authenticationType' => 'BASIC|OAUTH2|CUSTOM', 'oAuth2Properties' => [ 'authorizationCodeProperties' => [ 'authorizationCode' => '<string>', 'redirectUri' => '<string>', ], 'oAuth2ClientApplication' => [ 'aWSManagedClientApplicationReference' => '<string>', 'userManagedClientApplicationClientId' => '<string>', ], 'oAuth2Credentials' => [ 'accessToken' => '<string>', 'jwtToken' => '<string>', 'refreshToken' => '<string>', 'userManagedClientApplicationClientSecret' => '<string>', ], 'oAuth2GrantType' => 'AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER', 'tokenUrl' => '<string>', 'tokenUrlParametersMap' => ['<string>', ...], ], 'secretArn' => '<string>', ], 'compatibleComputeEnvironments' => ['<string>', ...], 'connectionProperties' => ['<string>', ...], 'connectionSchemaVersion' => <integer>, 'connectionType' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', 'creationTime' => <DateTime>, 'description' => '<string>', 'lastConnectionValidationTime' => <DateTime>, 'lastUpdatedBy' => '<string>', 'lastUpdatedTime' => <DateTime>, 'matchCriteria' => ['<string>', ...], 'name' => '<string>', 'physicalConnectionRequirements' => [ 'availabilityZone' => '<string>', 'securityGroupIdList' => ['<string>', ...], 'subnetId' => '<string>', 'subnetIdList' => ['<string>', ...], ], 'pythonProperties' => ['<string>', ...], 'sparkProperties' => ['<string>', ...], 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'statusReason' => '<string>', ], 'glueConnectionName' => '<string>', 'host' => '<string>', 'port' => <integer>, 'protocol' => 'ATHENA|GLUE_INTERACTIVE_SESSION|HTTPS|JDBC|LIVY|ODBC|PRISM', 'stage' => '<string>', ], // ... ], 'projectId' => '<string>', 'props' => [ 'athenaProperties' => [ 'workgroupName' => '<string>', ], 'glueProperties' => [ 'errorMessage' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', ], 'hyperPodProperties' => [ 'clusterArn' => '<string>', 'clusterName' => '<string>', 'orchestrator' => 'EKS|SLURM', ], 'iamProperties' => [ 'environmentId' => '<string>', 'glueLineageSyncEnabled' => true || false, ], 'redshiftProperties' => [ 'credentials' => [ 'secretArn' => '<string>', 'usernamePassword' => [ 'password' => '<string>', 'username' => '<string>', ], ], 'databaseName' => '<string>', 'isProvisionedSecret' => true || false, 'jdbcIamUrl' => '<string>', 'jdbcUrl' => '<string>', 'lineageSync' => [ 'enabled' => true || false, 'lineageJobId' => '<string>', 'schedule' => [ 'schedule' => '<string>', ], ], 'redshiftTempDir' => '<string>', 'status' => 'CREATING|CREATE_FAILED|DELETING|DELETE_FAILED|READY|UPDATING|UPDATE_FAILED|DELETED', 'storage' => [ 'clusterName' => '<string>', 'workgroupName' => '<string>', ], ], 'sparkEmrProperties' => [ 'computeArn' => '<string>', 'credentials' => [ 'password' => '<string>', 'username' => '<string>', ], 'credentialsExpiration' => <DateTime>, 'governanceType' => 'AWS_MANAGED|USER_MANAGED', 'instanceProfileArn' => '<string>', 'javaVirtualEnv' => '<string>', 'livyEndpoint' => '<string>', 'logUri' => '<string>', 'pythonVirtualEnv' => '<string>', 'runtimeRole' => '<string>', 'trustedCertificatesS3Uri' => '<string>', ], 'sparkGlueProperties' => [ 'additionalArgs' => [ 'connection' => '<string>', ], 'glueConnectionName' => '<string>', 'glueVersion' => '<string>', 'idleTimeout' => <integer>, 'javaVirtualEnv' => '<string>', 'numberOfWorkers' => <integer>, 'pythonVirtualEnv' => '<string>', 'workerType' => '<string>', ], ], 'type' => 'ATHENA|BIGQUERY|DATABRICKS|DOCUMENTDB|DYNAMODB|HYPERPOD|IAM|MYSQL|OPENSEARCH|ORACLE|POSTGRESQL|REDSHIFT|SAPHANA|SNOWFLAKE|SPARK|SQLSERVER|TERADATA|VERTICA|WORKFLOWS_MWAA', ]
Result Details
Members
- connectionId
-
- Required: Yes
- Type: string
The ID of the connection.
- description
-
- Type: string
The connection description.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where a connection is to be updated.
- domainUnitId
-
- Required: Yes
- Type: string
The ID of the domain unit where a connection is to be updated.
- environmentId
-
- Type: string
The ID of the environment where a connection is to be updated.
- name
-
- Required: Yes
- Type: string
The name of the connection.
- physicalEndpoints
-
- Required: Yes
- Type: Array of PhysicalEndpoint structures
The physical endpoints of the connection.
- projectId
-
- Type: string
The project ID of the connection.
- props
-
- Type: ConnectionPropertiesOutput structure
The connection props.
- type
-
- Required: Yes
- Type: string
The connection type.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
UpdateDataSource
$result = $client->updateDataSource
([/* ... */]); $promise = $client->updateDataSourceAsync
([/* ... */]);
Updates the specified data source in Amazon DataZone.
Parameter Syntax
$result = $client->updateDataSource([ 'assetFormsInput' => [ [ 'content' => '<string>', 'formName' => '<string>', // REQUIRED 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'configuration' => [ 'glueRunConfiguration' => [ 'autoImportDataQualityResult' => true || false, 'catalogName' => '<string>', 'dataAccessRole' => '<string>', 'relationalFilterConfigurations' => [ // REQUIRED [ 'databaseName' => '<string>', // REQUIRED 'filterExpressions' => [ [ 'expression' => '<string>', // REQUIRED 'type' => 'INCLUDE|EXCLUDE', // REQUIRED ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'redshiftRunConfiguration' => [ 'dataAccessRole' => '<string>', 'redshiftCredentialConfiguration' => [ 'secretManagerArn' => '<string>', // REQUIRED ], 'redshiftStorage' => [ 'redshiftClusterSource' => [ 'clusterName' => '<string>', // REQUIRED ], 'redshiftServerlessSource' => [ 'workgroupName' => '<string>', // REQUIRED ], ], 'relationalFilterConfigurations' => [ // REQUIRED [ 'databaseName' => '<string>', // REQUIRED 'filterExpressions' => [ [ 'expression' => '<string>', // REQUIRED 'type' => 'INCLUDE|EXCLUDE', // REQUIRED ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'sageMakerRunConfiguration' => [ 'trackingAssets' => [ // REQUIRED '<SageMakerAssetType>' => ['<string>', ...], // ... ], ], ], 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'enableSetting' => 'ENABLED|DISABLED', 'identifier' => '<string>', // REQUIRED 'name' => '<string>', 'publishOnImport' => true || false, 'recommendation' => [ 'enableBusinessNameGeneration' => 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', ], ]);
Parameter Details
Members
- assetFormsInput
-
- Type: Array of FormInput structures
The asset forms to be updated as part of the
UpdateDataSource
action. - configuration
-
- Type: DataSourceConfigurationInput structure
The configuration to be updated as part of the
UpdateDataSource
action. - description
-
- Type: string
The description to be updated as part of the
UpdateDataSource
action. - domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the domain in which to update a data source.
- enableSetting
-
- Type: string
The enable setting to be updated as part of the
UpdateDataSource
action. - identifier
-
- Required: Yes
- Type: string
The identifier of the data source to be updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateDataSource
action. - publishOnImport
-
- Type: boolean
The publish on import setting to be updated as part of the
UpdateDataSource
action. - recommendation
-
- Type: RecommendationConfiguration structure
The recommendation to be updated as part of the
UpdateDataSource
action. - 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 to be updated as part of the
UpdateDataSource
action.
Result Syntax
[ 'assetFormsOutput' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'configuration' => [ 'glueRunConfiguration' => [ 'accountId' => '<string>', 'autoImportDataQualityResult' => true || false, 'catalogName' => '<string>', 'dataAccessRole' => '<string>', 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'redshiftRunConfiguration' => [ 'accountId' => '<string>', 'dataAccessRole' => '<string>', 'redshiftCredentialConfiguration' => [ 'secretManagerArn' => '<string>', ], 'redshiftStorage' => [ 'redshiftClusterSource' => [ 'clusterName' => '<string>', ], 'redshiftServerlessSource' => [ 'workgroupName' => '<string>', ], ], 'region' => '<string>', 'relationalFilterConfigurations' => [ [ 'databaseName' => '<string>', 'filterExpressions' => [ [ 'expression' => '<string>', 'type' => 'INCLUDE|EXCLUDE', ], // ... ], 'schemaName' => '<string>', ], // ... ], ], 'sageMakerRunConfiguration' => [ 'accountId' => '<string>', 'region' => '<string>', 'trackingAssets' => [ '<SageMakerAssetType>' => ['<string>', ...], // ... ], ], ], 'connectionId' => '<string>', 'createdAt' => <DateTime>, 'description' => '<string>', 'domainId' => '<string>', 'enableSetting' => 'ENABLED|DISABLED', 'environmentId' => '<string>', 'errorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'id' => '<string>', 'lastRunAt' => <DateTime>, 'lastRunErrorMessage' => [ 'errorDetail' => '<string>', 'errorType' => 'ACCESS_DENIED_EXCEPTION|CONFLICT_EXCEPTION|INTERNAL_SERVER_EXCEPTION|RESOURCE_NOT_FOUND_EXCEPTION|SERVICE_QUOTA_EXCEEDED_EXCEPTION|THROTTLING_EXCEPTION|VALIDATION_EXCEPTION', ], 'lastRunStatus' => 'REQUESTED|RUNNING|FAILED|PARTIALLY_SUCCEEDED|SUCCESS', 'name' => '<string>', 'projectId' => '<string>', 'publishOnImport' => true || false, 'recommendation' => [ 'enableBusinessNameGeneration' => true || false, ], '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 forms to be updated as part of the
UpdateDataSource
action. - configuration
-
- Type: DataSourceConfigurationOutput structure
The configuration to be updated as part of the
UpdateDataSource
action. - connectionId
-
- Type: string
The connection ID.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was updated.
- description
-
- Type: string
The description to be updated as part of the
UpdateDataSource
action. - domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a data source is to be updated.
- enableSetting
-
- Type: string
The enable setting to be updated as part of the
UpdateDataSource
action. - environmentId
-
- Type: string
The identifier of the environment in which a data source is to be updated.
- errorMessage
-
- Type: DataSourceErrorMessage structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The identifier of the data source to be updated.
- lastRunAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was last run.
- lastRunErrorMessage
-
- Type: DataSourceErrorMessage structure
The last run error message of the data source.
- lastRunStatus
-
- Type: string
The last run status of the data source.
- name
-
- Required: Yes
- Type: string
The name to be updated as part of the
UpdateDataSource
action. - projectId
-
- Required: Yes
- Type: string
The identifier of the project where data source is to be updated.
- publishOnImport
-
- Type: boolean
The publish on import setting to be updated as part of the
UpdateDataSource
action. - recommendation
-
- Type: RecommendationConfiguration structure
The recommendation to be updated as part of the
UpdateDataSource
action. - 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 to be updated as part of the
UpdateDataSource
action. - selfGrantStatus
-
- Type: SelfGrantStatusOutput structure
Specifies the status of the self-granting functionality.
- status
-
- Type: string
The status to be updated as part of the
UpdateDataSource
action. - type
-
- Type: string
The type to be updated as part of the
UpdateDataSource
action. - 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.
UpdateDomain
$result = $client->updateDomain
([/* ... */]); $promise = $client->updateDomainAsync
([/* ... */]);
Updates a Amazon DataZone domain.
Parameter Syntax
$result = $client->updateDomain([ 'clientToken' => '<string>', 'description' => '<string>', 'domainExecutionRole' => '<string>', 'identifier' => '<string>', // REQUIRED 'name' => '<string>', 'serviceRole' => '<string>', 'singleSignOn' => [ 'type' => 'IAM_IDC|DISABLED', 'userAssignment' => 'AUTOMATIC|MANUAL', ], ]);
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 to be updated as part of the
UpdateDomain
action. - domainExecutionRole
-
- Type: string
The domain execution role to be updated as part of the
UpdateDomain
action. - identifier
-
- Required: Yes
- Type: string
The ID of the Amazon Web Services domain that is to be updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateDomain
action. - serviceRole
-
- Type: string
The service role of the domain.
- singleSignOn
-
- Type: SingleSignOn structure
The single sign-on option to be updated as part of the
UpdateDomain
action.
Result Syntax
[ 'description' => '<string>', 'domainExecutionRole' => '<string>', 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'rootDomainUnitId' => '<string>', 'serviceRole' => '<string>', 'singleSignOn' => [ 'type' => 'IAM_IDC|DISABLED', 'userAssignment' => 'AUTOMATIC|MANUAL', ], ]
Result Details
Members
- description
-
- Type: string
The description to be updated as part of the
UpdateDomain
action. - domainExecutionRole
-
- Type: string
The domain execution role to be updated as part of the
UpdateDomain
action. - id
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Specifies the timestamp of when the domain was last updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateDomain
action. - rootDomainUnitId
-
- Type: string
The ID of the root domain unit.
- serviceRole
-
- Type: string
The service role of the domain.
- singleSignOn
-
- Type: SingleSignOn structure
The single sign-on option of 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.
UpdateDomainUnit
$result = $client->updateDomainUnit
([/* ... */]); $promise = $client->updateDomainUnitAsync
([/* ... */]);
Updates the domain unit.
Parameter Syntax
$result = $client->updateDomainUnit([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'name' => '<string>', ]);
Parameter Details
Members
- description
-
- Type: string
The description of the domain unit that you want to update.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where you want to update a domain unit.
- identifier
-
- Required: Yes
- Type: string
The ID of the domain unit that you want to update.
- name
-
- Type: string
The name of the domain unit that you want to update.
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 that you want to update was created.
- createdBy
-
- Type: string
The user who created the domain unit that you want to update.
- description
-
- Type: string
The description of the domain unit that you want to update.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where you want to update the domain unit.
- id
-
- Required: Yes
- Type: string
The ID of the domain unit that you want to update.
- 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 that you want to update.
- owners
-
- Required: Yes
- Type: Array of DomainUnitOwnerProperties structures
The owners of the domain unit that you want to update.
- 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.
- 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.
UpdateEnvironment
$result = $client->updateEnvironment
([/* ... */]); $promise = $client->updateEnvironmentAsync
([/* ... */]);
Updates the specified environment in Amazon DataZone.
Parameter Syntax
$result = $client->updateEnvironment([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', // REQUIRED 'name' => '<string>', ]);
Parameter Details
Members
- description
-
- Type: string
The description to be updated as part of the
UpdateEnvironment
action. - domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the domain in which the environment is to be updated.
- glossaryTerms
-
- Type: Array of strings
The glossary terms to be updated as part of the
UpdateEnvironment
action. - identifier
-
- Required: Yes
- Type: string
The identifier of the environment that is to be updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateEnvironment
action.
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 identifier of the Amazon Web Services account in which the environment is to be updated.
- awsAccountRegion
-
- Type: string
The Amazon Web Services Region in which the environment is updated.
- 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 to be updated as part of the
UpdateEnvironment
action. - description
-
- Type: string
The description to be updated as part of the
UpdateEnvironment
action. - domainId
-
- Required: Yes
- Type: string
The identifier of the domain in which the environment is to be updated.
- environmentActions
-
- Type: Array of ConfigurableEnvironmentAction structures
The environment actions to be updated as part of the
UpdateEnvironment
action. - environmentBlueprintId
-
- Type: string
The blueprint identifier of the environment.
- environmentProfileId
-
- Type: string
The profile identifier of the environment.
- glossaryTerms
-
- Type: Array of strings
The glossary terms to be updated as part of the
UpdateEnvironment
action. - id
-
- Type: string
The identifier of the environment that is to be updated.
- lastDeployment
-
- Type: Deployment structure
The last deployment of the environment.
- name
-
- Required: Yes
- Type: string
The name to be updated as part of the
UpdateEnvironment
action. - projectId
-
- Required: Yes
- Type: string
The project identifier of the environment.
- provider
-
- Required: Yes
- Type: string
The provider identifier of the environment.
- provisionedResources
-
- Type: Array of Resource structures
The provisioned resources to be updated as part of the
UpdateEnvironment
action. - provisioningProperties
-
- Type: ProvisioningProperties structure
The provisioning properties to be updated as part of the
UpdateEnvironment
action. - status
-
- Type: string
The status to be updated as part of the
UpdateEnvironment
action. - updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment was updated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters to be updated as part of the
UpdateEnvironment
action.
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.
UpdateEnvironmentAction
$result = $client->updateEnvironmentAction
([/* ... */]); $promise = $client->updateEnvironmentActionAsync
([/* ... */]);
Updates an environment action.
Parameter Syntax
$result = $client->updateEnvironmentAction([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'name' => '<string>', 'parameters' => [ 'awsConsoleLink' => [ 'uri' => '<string>', ], ], ]);
Parameter Details
Members
- description
-
- Type: string
The description of the environment action.
- domainIdentifier
-
- Required: Yes
- Type: string
The domain ID of the environment action.
- environmentIdentifier
-
- Required: Yes
- Type: string
The environment ID of the environment action.
- identifier
-
- Required: Yes
- Type: string
The ID of the environment action.
- name
-
- Type: string
The name of the environment action.
- parameters
-
- 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 domain ID of the environment action.
- 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.
- 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.
UpdateEnvironmentProfile
$result = $client->updateEnvironmentProfile
([/* ... */]); $promise = $client->updateEnvironmentProfileAsync
([/* ... */]);
Updates the specified environment profile in Amazon DataZone.
Parameter Syntax
$result = $client->updateEnvironmentProfile([ 'awsAccountId' => '<string>', 'awsAccountRegion' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'name' => '<string>', 'userParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ]);
Parameter Details
Members
- awsAccountId
-
- Type: string
The Amazon Web Services account in which a specified environment profile is to be udpated.
- awsAccountRegion
-
- Type: string
The Amazon Web Services Region in which a specified environment profile is to be updated.
- description
-
- Type: string
The description to be updated as part of the
UpdateEnvironmentProfile
action. - domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which an environment profile is to be updated.
- identifier
-
- Required: Yes
- Type: string
The identifier of the environment profile that is to be updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateEnvironmentProfile
action. - userParameters
-
- Type: Array of EnvironmentParameter structures
The user parameters to be updated as part of the
UpdateEnvironmentProfile
action.
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 in which a specified environment profile is to be udpated.
- awsAccountRegion
-
- Type: string
The Amazon Web Services Region in which a specified environment profile is to be updated.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment profile was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the environment profile.
- description
-
- Type: string
The description to be updated as part of the
UpdateEnvironmentProfile
action. - domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the environment profile is to be updated.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The identifier of the blueprint of the environment profile that is to be updated.
- id
-
- Required: Yes
- Type: string
The identifier of the environment profile that is to be udpated.
- name
-
- Required: Yes
- Type: string
The name to be updated as part of the
UpdateEnvironmentProfile
action. - projectId
-
- Type: string
The identifier of the project of the environment profile that is to be updated.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment profile was updated.
- userParameters
-
- Type: Array of CustomParameter structures
The user parameters to be updated as part of the
UpdateEnvironmentProfile
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.
- 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.
UpdateGlossary
$result = $client->updateGlossary
([/* ... */]); $promise = $client->updateGlossaryAsync
([/* ... */]);
Updates the business glossary in Amazon DataZone.
Parameter Syntax
$result = $client->updateGlossary([ 'clientToken' => '<string>', 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'name' => '<string>', '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 to be updated as part of the
UpdateGlossary
action. - domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a business glossary is to be updated.
- identifier
-
- Required: Yes
- Type: string
The identifier of the business glossary to be updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateGlossary
action. - status
-
- Type: string
The status to be updated as part of the
UpdateGlossary
action.
Result Syntax
[ 'description' => '<string>', 'domainId' => '<string>', 'id' => '<string>', 'name' => '<string>', 'owningProjectId' => '<string>', 'status' => 'DISABLED|ENABLED', ]
Result Details
Members
- description
-
- Type: string
The description to be updated as part of the
UpdateGlossary
action. - domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a business glossary is to be updated.
- id
-
- Required: Yes
- Type: string
The identifier of the business glossary that is to be updated.
- name
-
- Required: Yes
- Type: string
The name to be updated as part of the
UpdateGlossary
action. - owningProjectId
-
- Required: Yes
- Type: string
The identifier of the project in which to update a business glossary.
- status
-
- Type: string
The status to be updated as part of the
UpdateGlossary
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.
UpdateGlossaryTerm
$result = $client->updateGlossaryTerm
([/* ... */]); $promise = $client->updateGlossaryTermAsync
([/* ... */]);
Updates a business glossary term in Amazon DataZone.
Parameter Syntax
$result = $client->updateGlossaryTerm([ 'domainIdentifier' => '<string>', // REQUIRED 'glossaryIdentifier' => '<string>', 'identifier' => '<string>', // REQUIRED 'longDescription' => '<string>', 'name' => '<string>', 'shortDescription' => '<string>', 'status' => 'ENABLED|DISABLED', 'termRelations' => [ 'classifies' => ['<string>', ...], 'isA' => ['<string>', ...], ], ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a business glossary term is to be updated.
- glossaryIdentifier
-
- Type: string
The identifier of the business glossary in which a term is to be updated.
- identifier
-
- Required: Yes
- Type: string
The identifier of the business glossary term that is to be updated.
- longDescription
-
- Type: string
The long description to be updated as part of the
UpdateGlossaryTerm
action. - name
-
- Type: string
The name to be updated as part of the
UpdateGlossaryTerm
action. - shortDescription
-
- Type: string
The short description to be updated as part of the
UpdateGlossaryTerm
action. - status
-
- Type: string
The status to be updated as part of the
UpdateGlossaryTerm
action. - termRelations
-
- Type: TermRelations structure
The term relations to be updated as part of the
UpdateGlossaryTerm
action.
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 identifier of the Amazon DataZone domain in which a business glossary term is to be updated.
- glossaryId
-
- Required: Yes
- Type: string
The identifier of the business glossary in which a term is to be updated.
- id
-
- Required: Yes
- Type: string
The identifier of the business glossary term that is to be updated.
- longDescription
-
- Type: string
The long description to be updated as part of the
UpdateGlossaryTerm
action. - name
-
- Required: Yes
- Type: string
The name to be updated as part of the
UpdateGlossaryTerm
action. - shortDescription
-
- Type: string
The short description to be updated as part of the
UpdateGlossaryTerm
action. - status
-
- Required: Yes
- Type: string
The status to be updated as part of the
UpdateGlossaryTerm
action. - termRelations
-
- Type: TermRelations structure
The term relations to be updated as part of the
UpdateGlossaryTerm
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.
UpdateGroupProfile
$result = $client->updateGroupProfile
([/* ... */]); $promise = $client->updateGroupProfileAsync
([/* ... */]);
Updates the specified group profile in Amazon DataZone.
Parameter Syntax
$result = $client->updateGroupProfile([ 'domainIdentifier' => '<string>', // REQUIRED 'groupIdentifier' => '<string>', // REQUIRED 'status' => 'ASSIGNED|NOT_ASSIGNED', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a group profile is updated.
- groupIdentifier
-
- Required: Yes
- Type: string
The identifier of the group profile that is updated.
- status
-
- Required: Yes
- Type: string
The status of the group profile that is updated.
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 a group profile is updated.
- groupName
-
- Type: string
The name of the group profile that is updated.
- id
-
- Type: string
The identifier of the group profile that is updated.
- status
-
- Type: string
The status of the group profile that is updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
UpdateProject
$result = $client->updateProject
([/* ... */]); $promise = $client->updateProjectAsync
([/* ... */]);
Updates the specified project in Amazon DataZone.
Parameter Syntax
$result = $client->updateProject([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'environmentDeploymentDetails' => [ 'environmentFailureReasons' => [ '<String>' => [ [ 'code' => '<string>', 'message' => '<string>', // REQUIRED ], // ... ], // ... ], 'overallDeploymentStatus' => 'PENDING_DEPLOYMENT|IN_PROGRESS|SUCCESSFUL|FAILED_VALIDATION|FAILED_DEPLOYMENT', ], 'glossaryTerms' => ['<string>', ...], 'identifier' => '<string>', // REQUIRED 'name' => '<string>', ]);
Parameter Details
Members
- description
-
- Type: string
The description to be updated as part of the
UpdateProject
action. - domainIdentifier
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain where a project is being updated.
- environmentDeploymentDetails
-
- Type: EnvironmentDeploymentDetails structure
The environment deployment details of the project.
- glossaryTerms
-
- Type: Array of strings
The glossary terms to be updated as part of the
UpdateProject
action. - identifier
-
- Required: Yes
- Type: string
The identifier of the project that is to be updated.
- name
-
- Type: string
The name to be updated as part of the
UpdateProject
action.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentDeploymentDetails' => [ 'environmentFailureReasons' => [ '<String>' => [ [ 'code' => '<string>', 'message' => '<string>', ], // ... ], // ... ], 'overallDeploymentStatus' => 'PENDING_DEPLOYMENT|IN_PROGRESS|SUCCESSFUL|FAILED_VALIDATION|FAILED_DEPLOYMENT', ], 'failureReasons' => [ [ 'code' => '<string>', 'message' => '<string>', ], // ... ], 'glossaryTerms' => ['<string>', ...], 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'projectProfileId' => '<string>', 'projectStatus' => 'ACTIVE|DELETING|DELETE_FAILED', 'userParameters' => [ [ 'environmentConfigurationName' => '<string>', 'environmentParameters' => [ [ 'name' => '<string>', 'value' => '<string>', ], // ... ], ], // ... ], ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the project.
- description
-
- Type: string
The description of the project that is to be updated.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a project is updated.
- domainUnitId
-
- Type: string
The ID of the domain unit.
- environmentDeploymentDetails
-
- Type: EnvironmentDeploymentDetails structure
The environment deployment details of the project.
- failureReasons
-
- Type: Array of ProjectDeletionError structures
Specifies the error message that is returned if the operation cannot be successfully completed.
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the project that are to be updated.
- id
-
- Required: Yes
- Type: string
The identifier of the project that is to be updated.
- 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 that is to be updated.
- projectProfileId
-
- Type: string
The ID of the project profile.
- projectStatus
-
- Type: string
The status of the project.
- userParameters
-
- Type: Array of EnvironmentConfigurationUserParameter structures
The user parameters of the project.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- ServiceQuotaExceededException:
The request has exceeded the specified service quota.
- ConflictException:
There is a conflict while performing this action.
- ValidationException:
The input fails to satisfy the constraints specified by the Amazon Web Services service.
- UnauthorizedException:
You do not have permission to perform this action.
UpdateProjectProfile
$result = $client->updateProjectProfile
([/* ... */]); $promise = $client->updateProjectProfileAsync
([/* ... */]);
Updates a project profile.
Parameter Syntax
$result = $client->updateProjectProfile([ 'description' => '<string>', 'domainIdentifier' => '<string>', // REQUIRED 'domainUnitIdentifier' => '<string>', 'environmentConfigurations' => [ [ 'awsAccount' => [ // REQUIRED 'awsAccountId' => '<string>', 'awsAccountIdPath' => '<string>', ], 'awsRegion' => [ // REQUIRED 'regionName' => '<string>', 'regionNamePath' => '<string>', ], 'configurationParameters' => [ 'parameterOverrides' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'resolvedParameters' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'ssmPath' => '<string>', ], 'deploymentMode' => 'ON_CREATE|ON_DEMAND', 'deploymentOrder' => <integer>, 'description' => '<string>', 'environmentBlueprintId' => '<string>', // REQUIRED 'id' => '<string>', 'name' => '<string>', // REQUIRED ], // ... ], 'identifier' => '<string>', // REQUIRED 'name' => '<string>', 'status' => 'ENABLED|DISABLED', ]);
Parameter Details
Members
- description
-
- Type: string
The description of a project profile.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain where a project profile is to be updated.
- domainUnitIdentifier
-
- Type: string
The ID of the domain unit where a project profile is to be updated.
- environmentConfigurations
-
- Type: Array of EnvironmentConfiguration structures
The environment configurations of a project profile.
- identifier
-
- Required: Yes
- Type: string
The ID of a project profile that is to be updated.
- name
-
- Type: string
The name of a project profile.
- status
-
- Type: string
The status of a project profile.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'domainId' => '<string>', 'domainUnitId' => '<string>', 'environmentConfigurations' => [ [ 'awsAccount' => [ 'awsAccountId' => '<string>', 'awsAccountIdPath' => '<string>', ], 'awsRegion' => [ 'regionName' => '<string>', 'regionNamePath' => '<string>', ], 'configurationParameters' => [ 'parameterOverrides' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'resolvedParameters' => [ [ 'isEditable' => true || false, 'name' => '<string>', 'value' => '<string>', ], // ... ], 'ssmPath' => '<string>', ], 'deploymentMode' => 'ON_CREATE|ON_DEMAND', 'deploymentOrder' => <integer>, 'description' => '<string>', 'environmentBlueprintId' => '<string>', 'id' => '<string>', 'name' => '<string>', ], // ... ], 'id' => '<string>', 'lastUpdatedAt' => <DateTime>, 'name' => '<string>', 'status' => 'ENABLED|DISABLED', ]
Result Details
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which a project profile is created.
- createdBy
-
- Required: Yes
- Type: string
The user who created a project profile.
- description
-
- Type: string
The description of a project profile.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where project profile is to be updated.
- domainUnitId
-
- Type: string
The domain unit ID of the project profile to be updated.
- environmentConfigurations
-
- Type: Array of EnvironmentConfiguration structures
The environment configurations of a project profile.
- id
-
- Required: Yes
- Type: string
The ID of the project profile.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which a project profile was last updated.
- name
-
- Required: Yes
- Type: string
The name of the project profile.
- status
-
- Type: string
The status of the project profile.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- 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.
UpdateRule
$result = $client->updateRule
([/* ... */]); $promise = $client->updateRuleAsync
([/* ... */]);
Updates a rule. In Amazon DataZone, a rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.
Parameter Syntax
$result = $client->updateRule([ 'description' => '<string>', 'detail' => [ 'metadataFormEnforcementDetail' => [ 'requiredMetadataForms' => [ [ 'typeIdentifier' => '<string>', // REQUIRED 'typeRevision' => '<string>', // REQUIRED ], // ... ], ], ], 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'includeChildDomainUnits' => true || false, 'name' => '<string>', 'scope' => [ 'assetType' => [ 'selectionMode' => 'ALL|SPECIFIC', // REQUIRED 'specificAssetTypes' => ['<string>', ...], ], 'dataProduct' => true || false, 'project' => [ 'selectionMode' => 'ALL|SPECIFIC', // REQUIRED 'specificProjects' => ['<string>', ...], ], ], ]);
Parameter Details
Members
- description
-
- Type: string
The description of the rule.
- detail
-
- Type: RuleDetail structure
The detail of the rule.
- domainIdentifier
-
- Required: Yes
- Type: string
The ID of the domain in which a rule is to be updated.
- identifier
-
- Required: Yes
- Type: string
The ID of the rule that is to be updated
- includeChildDomainUnits
-
- Type: boolean
Specifies whether to update this rule in the child domain units.
- name
-
- Type: string
The name of the rule.
- scope
-
- Type: RuleScope structure
The scrope of the rule.
Result Syntax
[ 'action' => 'CREATE_SUBSCRIPTION_REQUEST', 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'description' => '<string>', 'detail' => [ 'metadataFormEnforcementDetail' => [ 'requiredMetadataForms' => [ [ 'typeIdentifier' => '<string>', 'typeRevision' => '<string>', ], // ... ], ], ], 'identifier' => '<string>', 'lastUpdatedBy' => '<string>', 'name' => '<string>', 'revision' => '<string>', 'ruleType' => 'METADATA_FORM_ENFORCEMENT', 'scope' => [ 'assetType' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificAssetTypes' => ['<string>', ...], ], 'dataProduct' => true || false, 'project' => [ 'selectionMode' => 'ALL|SPECIFIC', 'specificProjects' => ['<string>', ...], ], ], 'target' => [ 'domainUnitTarget' => [ 'domainUnitId' => '<string>', 'includeChildDomainUnits' => true || false, ], ], 'updatedAt' => <DateTime>, ]
Result Details
Members
- action
-
- Required: Yes
- Type: string
The action of the rule.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the rule was created.
- createdBy
-
- Required: Yes
- Type: string
The user who created the rule.
- description
-
- Type: string
The description of the rule.
- detail
-
- Required: Yes
- Type: RuleDetail structure
The detail of the rule.
- identifier
-
- Required: Yes
- Type: string
The ID of the rule.
- lastUpdatedBy
-
- Required: Yes
- Type: string
The timestamp at which the rule was last updated.
- name
-
- Required: Yes
- Type: string
The name of the rule.
- revision
-
- Required: Yes
- Type: string
The revision of the rule.
- ruleType
-
- Required: Yes
- Type: string
The type of the rule.
- scope
-
- Required: Yes
- Type: RuleScope structure
The scope of the rule.
- target
-
- Required: Yes
- Type: RuleTarget structure
The target of the rule.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the rule was last updated.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- 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.
UpdateSubscriptionGrantStatus
$result = $client->updateSubscriptionGrantStatus
([/* ... */]); $promise = $client->updateSubscriptionGrantStatusAsync
([/* ... */]);
Updates the status of the specified subscription grant status in Amazon DataZone.
Parameter Syntax
$result = $client->updateSubscriptionGrantStatus([ 'assetIdentifier' => '<string>', // REQUIRED 'domainIdentifier' => '<string>', // REQUIRED 'failureCause' => [ 'message' => '<string>', ], 'identifier' => '<string>', // REQUIRED 'status' => 'GRANT_PENDING|REVOKE_PENDING|GRANT_IN_PROGRESS|REVOKE_IN_PROGRESS|GRANTED|REVOKED|GRANT_FAILED|REVOKE_FAILED', // REQUIRED 'targetName' => '<string>', ]);
Parameter Details
Members
- assetIdentifier
-
- Required: Yes
- Type: string
The identifier of the asset the subscription grant status of which is to be updated.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription grant status is to be updated.
- failureCause
-
- Type: FailureCause structure
Specifies the error message that is returned if the operation cannot be successfully completed.
- identifier
-
- Required: Yes
- Type: string
The identifier of the subscription grant the status of which is to be updated.
- status
-
- Required: Yes
- Type: string
The status to be updated as part of the
UpdateSubscriptionGrantStatus
action. - targetName
-
- Type: string
The target name to be updated as part of the
UpdateSubscriptionGrantStatus
action.
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 details of the asset 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 status was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone domain user who created the subscription grant status.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription grant status is to be updated.
- grantedEntity
-
- Required: Yes
- Type: GrantedEntity structure
The granted entity to be updated as part of the
UpdateSubscriptionGrantStatus
action. - id
-
- Required: Yes
- Type: string
The identifier of the subscription grant.
- status
-
- Required: Yes
- Type: string
The status to be updated as part of the
UpdateSubscriptionGrantStatus
action. - subscriptionId
-
- Type: string
The identifier of the subscription.
- subscriptionTargetId
-
- Required: Yes
- Type: string
The identifier of the subscription target whose subscription grant status is to be updated.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription grant status is to be updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription grant status.
Errors
- InternalServerException:
The request has failed because of an unknown error, exception or failure.
- ResourceNotFoundException:
The specified resource cannot be found.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ThrottlingException:
The request was denied due to request throttling.
- 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.
UpdateSubscriptionRequest
$result = $client->updateSubscriptionRequest
([/* ... */]); $promise = $client->updateSubscriptionRequestAsync
([/* ... */]);
Updates a specified subscription request in Amazon DataZone.
Parameter Syntax
$result = $client->updateSubscriptionRequest([ 'domainIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'requestReason' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription request is to be updated.
- identifier
-
- Required: Yes
- Type: string
The identifier of the subscription request that is to be updated.
- requestReason
-
- Required: Yes
- Type: string
The reason for the
UpdateSubscriptionRequest
action.
Result Syntax
[ 'createdAt' => <DateTime>, 'createdBy' => '<string>', 'decisionComment' => '<string>', 'domainId' => '<string>', 'existingSubscriptionId' => '<string>', 'id' => '<string>', 'metadataForms' => [ [ 'content' => '<string>', 'formName' => '<string>', 'typeName' => '<string>', 'typeRevision' => '<string>', ], // ... ], 'requestReason' => '<string>', 'reviewerId' => '<string>', 'status' => 'PENDING|ACCEPTED|REJECTED', 'subscribedListings' => [ [ 'description' => '<string>', 'id' => '<string>', 'item' => [ 'assetListing' => [ 'assetScope' => [ 'assetId' => '<string>', 'errorMessage' => '<string>', 'filterIds' => ['<string>', ...], 'status' => '<string>', ], 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', 'forms' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], ], 'productListing' => [ 'assetListings' => [ [ 'entityId' => '<string>', 'entityRevision' => '<string>', 'entityType' => '<string>', ], // ... ], 'description' => '<string>', 'entityId' => '<string>', 'entityRevision' => '<string>', 'glossaryTerms' => [ [ 'name' => '<string>', 'shortDescription' => '<string>', ], // ... ], 'name' => '<string>', ], ], 'name' => '<string>', 'ownerProjectId' => '<string>', 'ownerProjectName' => '<string>', 'revision' => '<string>', ], // ... ], 'subscribedPrincipals' => [ [ 'project' => [ 'id' => '<string>', 'name' => '<string>', ], ], // ... ], 'updatedAt' => <DateTime>, 'updatedBy' => '<string>', ]
Result Details
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the 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
UpdateSubscriptionRequest
action. - domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription request is to be updated.
- existingSubscriptionId
-
- Type: string
The ID of the existing subscription.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription request that is to be updated.
- metadataForms
-
- Type: Array of FormOutput structures
Metadata forms included in the subscription request.
- requestReason
-
- Required: Yes
- Type: string
The reason for the
UpdateSubscriptionRequest
action. - reviewerId
-
- Type: string
The identifier of the Amazon DataZone user who reviews 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 of the subscription request.
- 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.
UpdateSubscriptionTarget
$result = $client->updateSubscriptionTarget
([/* ... */]); $promise = $client->updateSubscriptionTargetAsync
([/* ... */]);
Updates the specified subscription target in Amazon DataZone.
Parameter Syntax
$result = $client->updateSubscriptionTarget([ 'applicableAssetTypes' => ['<string>', ...], 'authorizedPrincipals' => ['<string>', ...], 'domainIdentifier' => '<string>', // REQUIRED 'environmentIdentifier' => '<string>', // REQUIRED 'identifier' => '<string>', // REQUIRED 'manageAccessRole' => '<string>', 'name' => '<string>', 'provider' => '<string>', 'subscriptionTargetConfig' => [ [ 'content' => '<string>', // REQUIRED 'formName' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- applicableAssetTypes
-
- Type: Array of strings
The applicable asset types to be updated as part of the
UpdateSubscriptionTarget
action. - authorizedPrincipals
-
- Type: Array of strings
The authorized principals to be updated as part of the
UpdateSubscriptionTarget
action. - domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription target is to be updated.
- environmentIdentifier
-
- Required: Yes
- Type: string
The identifier of the environment in which a subscription target is to be updated.
- identifier
-
- Required: Yes
- Type: string
Identifier of the subscription target that is to be updated.
- manageAccessRole
-
- Type: string
The manage access role to be updated as part of the
UpdateSubscriptionTarget
action. - name
-
- Type: string
The name to be updated as part of the
UpdateSubscriptionTarget
action. - provider
-
- Type: string
The provider to be updated as part of the
UpdateSubscriptionTarget
action. - subscriptionTargetConfig
-
- Type: Array of SubscriptionTargetForm structures
The configuration to be updated as part of the
UpdateSubscriptionTarget
action.
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 applicable asset types to be updated as part of the
UpdateSubscriptionTarget
action. - authorizedPrincipals
-
- Required: Yes
- Type: Array of strings
The authorized principals to be updated as part of the
UpdateSubscriptionTarget
action. - createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a subscription target was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the subscription target.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription target is to be updated.
- environmentId
-
- Required: Yes
- Type: string
The identifier of the environment in which a subscription target is to be updated.
- id
-
- Required: Yes
- Type: string
Identifier of the subscription target that is to be updated.
- manageAccessRole
-
- Type: string
The manage access role to be updated as part of the
UpdateSubscriptionTarget
action. - name
-
- Required: Yes
- Type: string
The name to be updated as part of the
UpdateSubscriptionTarget
action. - projectId
-
- Required: Yes
- Type: string
The identifier of the project in which a subscription target is to be updated.
- provider
-
- Required: Yes
- Type: string
The provider to be updated as part of the
UpdateSubscriptionTarget
action. - subscriptionTargetConfig
-
- Required: Yes
- Type: Array of SubscriptionTargetForm structures
The configuration to be updated as part of the
UpdateSubscriptionTarget
action. - type
-
- Required: Yes
- Type: string
The type to be updated as part of the
UpdateSubscriptionTarget
action. - 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.
UpdateUserProfile
$result = $client->updateUserProfile
([/* ... */]); $promise = $client->updateUserProfileAsync
([/* ... */]);
Updates the specified user profile in Amazon DataZone.
Parameter Syntax
$result = $client->updateUserProfile([ 'domainIdentifier' => '<string>', // REQUIRED 'status' => 'ASSIGNED|NOT_ASSIGNED|ACTIVATED|DEACTIVATED', // REQUIRED 'type' => 'IAM|SSO', 'userIdentifier' => '<string>', // REQUIRED ]);
Parameter Details
Members
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a user profile is updated.
- status
-
- Required: Yes
- Type: string
The status of the user profile that are to be updated.
- type
-
- Type: string
The type of the user profile that are to be updated.
- userIdentifier
-
- Required: Yes
- Type: string
The identifier of the user whose user profile is to be updated.
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 updated.
- 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.
Shapes
AcceptChoice
Description
Specifies the prediction (aka, the automatically generated piece of metadata) and the target (for example, a column name) that can be accepted.
Members
- editedValue
-
- Type: string
The edit of the prediction.
- predictionChoice
-
- Type: int
Specifies the prediction (aka, the automatically generated piece of metadata) that can be accepted.
- predictionTarget
-
- Required: Yes
- Type: string
Specifies the target (for example, a column name) where a prediction can be accepted.
AcceptRule
Description
Specifies the rule and the threshold under which a prediction can be accepted.
Members
- rule
-
- Type: string
Specifies whether you want to accept the top prediction for all targets or none.
- threshold
-
- Type: float
The confidence score that specifies the condition at which a prediction can be accepted.
AcceptedAssetScope
Description
The accepted asset scope.
Members
- assetId
-
- Required: Yes
- Type: string
The asset ID of the accepted asset scope.
- filterIds
-
- Required: Yes
- Type: Array of strings
The filter IDs of the accepted asset scope.
AccessDeniedException
Description
You do not have sufficient access to perform this action.
Members
- message
-
- Required: Yes
- Type: string
ActionParameters
Description
The parameters of the environment action.
Members
- awsConsoleLink
-
- Type: AwsConsoleLinkParameters structure
The console link specified as part of the environment action.
AddToProjectMemberPoolPolicyGrantDetail
Description
The details of the policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy grant is applied to child domain units.
AllDomainUnitsGrantFilter
Description
The grant filter for all domain units.
Members
AllUsersGrantFilter
Description
The all users grant filter.
Members
AssetFilterConfiguration
Description
The configuration details of the asset filter.
Members
- columnConfiguration
-
- Type: ColumnFilterConfiguration structure
The column configuration of the asset filter.
- rowConfiguration
-
- Type: RowFilterConfiguration structure
The row configuration of the asset filter.
AssetFilterSummary
Description
The summary of the asset filter.
Members
- assetId
-
- Required: Yes
- Type: string
The ID of the data asset.
- 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 lives.
- effectiveColumnNames
-
- Type: Array of strings
The effective column names of the asset filter.
- effectiveRowFilter
-
- Type: string
The effective row filter of the asset filter.
- errorMessage
-
- Type: string
The error message that is displayed if the action does not succeed.
- 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.
AssetInDataProductListingItem
Description
The listing of the asset in a data product.
Members
- entityId
-
- Type: string
The entity ID of the listing of the asset in a data product.
- entityRevision
-
- Type: string
The entity revision of the listing of the asset in a data product.
- entityType
-
- Type: string
The entity type of the listing of the asset in a data product.
AssetItem
Description
A Amazon DataZone inventory asset.
Members
- additionalAttributes
-
- Type: AssetItemAdditionalAttributes structure
The additional attributes of a Amazon DataZone inventory asset.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the Amazon DataZone inventory asset was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created the inventory asset.
- description
-
- Type: string
The description of an Amazon DataZone inventory asset.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the inventory asset exists.
- externalIdentifier
-
- Type: string
The external identifier of the Amazon DataZone inventory asset.
- firstRevisionCreatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the first revision of the inventory asset was created.
- firstRevisionCreatedBy
-
- Type: string
The Amazon DataZone user who created the first revision of the inventory asset.
- glossaryTerms
-
- Type: Array of strings
The glossary terms attached to the Amazon DataZone inventory asset.
- identifier
-
- Required: Yes
- Type: string
the identifier of the Amazon DataZone inventory asset.
- name
-
- Required: Yes
- Type: string
The name of the Amazon DataZone inventory asset.
- owningProjectId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone project that owns the inventory asset.
- typeIdentifier
-
- Required: Yes
- Type: string
The identifier of the asset type of the specified Amazon DataZone inventory asset.
- typeRevision
-
- Required: Yes
- Type: string
The revision of the inventory asset type.
AssetItemAdditionalAttributes
Description
The additional attributes of an inventory asset.
Members
- formsOutput
-
- Type: Array of FormOutput structures
The forms included in the additional attributes of an inventory asset.
- latestTimeSeriesDataPointFormsOutput
-
- Type: Array of TimeSeriesDataPointSummaryFormOutput structures
The latest time series data points forms included in the additional attributes of an asset.
- readOnlyFormsOutput
-
- Type: Array of FormOutput structures
The read-only forms included in the additional attributes of an inventory asset.
AssetListing
Description
An asset published in an Amazon DataZone catalog.
Members
- assetId
-
- Type: string
The identifier of an asset published in an Amazon DataZone catalog.
- assetRevision
-
- Type: string
The revision of an asset published in an Amazon DataZone catalog.
- assetType
-
- Type: string
The type of an asset published in an Amazon DataZone catalog.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when an asset published in an Amazon DataZone catalog was created.
- forms
-
- Type: string
The metadata forms attached to an asset published in an Amazon DataZone catalog.
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms attached to an asset published in an Amazon DataZone catalog.
- latestTimeSeriesDataPointForms
-
- Type: Array of TimeSeriesDataPointSummaryFormOutput structures
The latest time series data points forms included in the additional attributes of an asset.
- owningProjectId
-
- Type: string
The identifier of the project where an asset published in an Amazon DataZone catalog exists.
AssetListingDetails
Description
The details of an asset published in an Amazon DataZone catalog.
Members
- listingId
-
- Required: Yes
- Type: string
The identifier of an asset published in an Amazon DataZone catalog.
- listingStatus
-
- Required: Yes
- Type: string
The status of an asset published in an Amazon DataZone catalog.
AssetListingItem
Description
The details of an asset published in an Amazon DataZone catalog.
Members
- additionalAttributes
-
- Type: AssetListingItemAdditionalAttributes structure
The additional attributes of an asset published in an Amazon DataZone catalog.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when an asset published in an Amazon DataZone catalog was created.
- description
-
- Type: string
The description of an asset published in an Amazon DataZone catalog.
- entityId
-
- Type: string
The identifier of the inventory asset.
- entityRevision
-
- Type: string
The revision of the inventory asset.
- entityType
-
- Type: string
The type of the inventory asset.
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
Glossary terms attached to the inventory asset.
- listingCreatedBy
-
- Type: string
The Amazon DataZone user who created the listing.
- listingId
-
- Type: string
The identifier of the listing (asset published in Amazon DataZone catalog).
- listingRevision
-
- Type: string
The revision of the listing (asset published in Amazon DataZone catalog).
- listingUpdatedBy
-
- Type: string
The Amazon DataZone user who updated the listing.
- name
-
- Type: string
The name of the inventory asset.
- owningProjectId
-
- Type: string
The identifier of the project that owns the inventory asset.
AssetListingItemAdditionalAttributes
Description
Additional attributes of an inventory asset.
Members
- forms
-
- Type: string
The metadata forms that form additional attributes of the metadata asset.
- latestTimeSeriesDataPointForms
-
- Type: Array of TimeSeriesDataPointSummaryFormOutput structures
The latest time series data points forms included in the additional attributes of an asset.
AssetRevision
Description
The revision of an inventory asset.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when an inventory asset revison was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created the asset revision.
- domainId
-
- Type: string
The Amazon DataZone user who created the inventory asset.
- id
-
- Type: string
The identifier of the inventory asset revision.
- revision
-
- Type: string
The revision details of the inventory asset.
AssetScope
Description
The asset scope.
Members
- assetId
-
- Required: Yes
- Type: string
The asset ID of the asset scope.
- errorMessage
-
- Type: string
The error message of the asset scope.
- filterIds
-
- Required: Yes
- Type: Array of strings
The filter IDs of the asset scope.
- status
-
- Required: Yes
- Type: string
The status of the asset scope.
AssetTargetNameMap
Description
The name map for assets.
Members
- assetId
-
- Required: Yes
- Type: string
The identifier of the inventory asset.
- targetName
-
- Required: Yes
- Type: string
The target name in the asset target name map.
AssetTypeItem
Description
The details of the asset type.
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 identifier of the Amazon DataZone domain where the asset type exists.
- formsOutput
-
- Required: Yes
- Type: Associative array of custom strings keys (FormName) to FormEntryOutput structures
The forms included in the details of the asset type.
- name
-
- Required: Yes
- Type: string
The name of the asset type.
- originDomainId
-
- Type: string
The identifier of the Amazon DataZone domain where the asset type was originally created.
- originProjectId
-
- Type: string
The identifier of the Amazon DataZone project where the asset type exists.
- owningProjectId
-
- Required: Yes
- Type: string
The identifier 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 who updated the asset type.
AssetTypesForRule
Description
The asset type for the rule details.
Members
- selectionMode
-
- Required: Yes
- Type: string
The selection mode for the rule.
- specificAssetTypes
-
- Type: Array of strings
The specific asset types that are included in the rule.
AthenaPropertiesInput
Description
The Amazon Athena properties of a connection.
Members
- workgroupName
-
- Type: string
The Amazon Athena workgroup name of a connection.
AthenaPropertiesOutput
Description
The Amazon Athena properties of a connection.
Members
- workgroupName
-
- Type: string
The Amazon Athena workgroup name of a connection.
AthenaPropertiesPatch
Description
The Amazon Athena properties patch of a connection.
Members
- workgroupName
-
- Type: string
The Amazon Athena workgroup name of a connection.
AuthenticationConfiguration
Description
The authentication configuration of a connection.
Members
- authenticationType
-
- Type: string
The authentication type of a connection.
- oAuth2Properties
-
- Type: OAuth2Properties structure
The oAuth2 properties of a connection.
- secretArn
-
- Type: string
The secret ARN of a connection.
AuthenticationConfigurationInput
Description
The authentication configuration of a connection.
Members
- authenticationType
-
- Type: string
The authentication type of a connection.
- basicAuthenticationCredentials
-
- Type: BasicAuthenticationCredentials structure
The basic authentication credentials of a connection.
- customAuthenticationCredentials
-
- Type: Associative array of custom strings keys (CredentialMapKeyString) to strings
The custom authentication credentials of a connection.
- kmsKeyArn
-
- Type: string
The KMS key ARN of a connection.
- oAuth2Properties
-
- Type: OAuth2Properties structure
The oAuth2 properties of a connection.
- secretArn
-
- Type: string
The secret ARN of a connection.
AuthenticationConfigurationPatch
Description
The authentication configuration patch of a connection.
Members
- basicAuthenticationCredentials
-
- Type: BasicAuthenticationCredentials structure
The basic authentication credentials of a connection.
- secretArn
-
- Type: string
The secret ARN of a connection.
AuthorizationCodeProperties
Description
The authorization code properties of a connection.
Members
- authorizationCode
-
- Type: string
The authorization code of a connection.
- redirectUri
-
- Type: string
The redirect URI of a connection.
AwsAccount
Description
The account ID of a project.
Members
- awsAccountId
-
- Type: string
The account ID of a project.
- awsAccountIdPath
-
- Type: string
The account ID path of a project.
AwsConsoleLinkParameters
Description
The parameters of the console link specified as part of the environment action.
Members
- uri
-
- Type: string
The URI of the console link specified as part of the environment action.
AwsLocation
Description
The location of a project.
Members
- accessRole
-
- Type: string
The access role of a connection.
- awsAccountId
-
- Type: string
The account ID of a connection.
- awsRegion
-
- Type: string
The Region of a connection.
- iamConnectionId
-
- Type: string
The IAM connection ID of a connection.
BasicAuthenticationCredentials
Description
The basic authentication credentials of a connection.
Members
- password
-
- Type: string
The password for a connection.
- userName
-
- Type: string
The user name for the connecion.
BusinessNameGenerationConfiguration
Description
The configuration of the business name generation.
Members
- enabled
-
- Type: boolean
Specifies whether the business name generation is enabled.
CloudFormationProperties
Description
Part of the provisioning properties of the environment blueprint.
Members
- templateUrl
-
- Required: Yes
- Type: string
The template URL of the cloud formation provisioning properties of the environment blueprint.
ColumnFilterConfiguration
Description
The column configuration of the asset filter.
Members
- includedColumnNames
-
- Type: Array of strings
Specifies whether to include column names.
ConfigurableActionParameter
Description
The details of the parameters for the configurable environment action.
Members
- key
-
- Type: string
The key of the configurable action parameter.
- value
-
- Type: string
The value of the configurable action parameter.
ConfigurableEnvironmentAction
Description
The configurable action of a Amazon DataZone environment.
Members
- auth
-
- Type: string
The authentication type of a configurable action of a Amazon DataZone environment.
- parameters
-
- Required: Yes
- Type: Array of ConfigurableActionParameter structures
The parameters of a configurable action in a Amazon DataZone environment.
- type
-
- Required: Yes
- Type: string
The type of a configurable action in a Amazon DataZone environment.
ConflictException
Description
There is a conflict while performing this action.
Members
- message
-
- Required: Yes
- Type: string
ConnectionCredentials
Description
The credentials of a connection.
Members
- accessKeyId
-
- Type: string
The access key ID of a connection.
- expiration
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The expiration of the connection credentials.
- secretAccessKey
-
- Type: string
The secret access key of a connection.
- sessionToken
-
- Type: string
The session token of a connection credentials.
ConnectionPropertiesInput
Description
The properties of a connection.
Members
- athenaProperties
-
- Type: AthenaPropertiesInput structure
The Amazon Athena properties of a connection.
- glueProperties
-
- Type: GluePropertiesInput structure
The Amazon Web Services Glue properties of a connection.
- hyperPodProperties
-
- Type: HyperPodPropertiesInput structure
The hyper pod properties of a connection.
- iamProperties
-
- Type: IamPropertiesInput structure
The IAM properties of a connection.
- redshiftProperties
-
- Type: RedshiftPropertiesInput structure
The Amazon Redshift properties of a connection.
- sparkEmrProperties
-
- Type: SparkEmrPropertiesInput structure
The Spark EMR properties of a connection.
- sparkGlueProperties
-
- Type: SparkGluePropertiesInput structure
The Spark Amazon Web Services Glue properties of a connection.
ConnectionPropertiesOutput
Description
The properties of a connection.
Members
- athenaProperties
-
- Type: AthenaPropertiesOutput structure
The Amazon Athena properties of a connection.
- glueProperties
-
- Type: GluePropertiesOutput structure
The Amazon Web Services Glue properties of a connection.
- hyperPodProperties
-
- Type: HyperPodPropertiesOutput structure
The hyper pod properties of a connection.
- iamProperties
-
- Type: IamPropertiesOutput structure
The IAM properties of a connection.
- redshiftProperties
-
- Type: RedshiftPropertiesOutput structure
The Amazon Redshift properties of a connection.
- sparkEmrProperties
-
- Type: SparkEmrPropertiesOutput structure
The Spark EMR properties of a connection.
- sparkGlueProperties
-
- Type: SparkGluePropertiesOutput structure
The Spark Amazon Web Services Glue properties of a connection.
ConnectionPropertiesPatch
Description
The connection properties patch.
Members
- athenaProperties
-
- Type: AthenaPropertiesPatch structure
The Amazon Athena properties of a connection properties patch.
- glueProperties
-
- Type: GluePropertiesPatch structure
The Amazon Web Services Glue properties of a connection properties patch.
- iamProperties
-
- Type: IamPropertiesPatch structure
The IAM properties of a connection properties patch.
- redshiftProperties
-
- Type: RedshiftPropertiesPatch structure
The Amazon Redshift properties of a connection properties patch.
- sparkEmrProperties
-
- Type: SparkEmrPropertiesPatch structure
The Spark EMR properties of a connection properties patch.
ConnectionSummary
Description
The summary of a connection.
Members
- connectionId
-
- Required: Yes
- Type: string
The ID of a connection.
- domainId
-
- Required: Yes
- Type: string
The domain ID of a connection.
- domainUnitId
-
- Required: Yes
- Type: string
The domain unit ID of a connection.
- environmentId
-
- Type: string
The environment ID of a connection.
- name
-
- Required: Yes
- Type: string
The connection name.
- physicalEndpoints
-
- Required: Yes
- Type: Array of PhysicalEndpoint structures
The connection physical endpoints.
- projectId
-
- Type: string
The connection project ID.
- props
-
- Type: ConnectionPropertiesOutput structure
The connection props.
- type
-
- Required: Yes
- Type: string
The connection type.
CreateAssetTypePolicyGrantDetail
Description
The details of the policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy grant is applied to child domain units.
CreateDomainUnitPolicyGrantDetail
Description
The details of the policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy grant is applied to child domain units.
CreateEnvironmentProfilePolicyGrantDetail
Description
The details of the policy grant.
Members
- domainUnitId
-
- Type: string
The ID of the domain unit.
CreateFormTypePolicyGrantDetail
Description
The details of the policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy grant is applied to child domain units.
CreateGlossaryPolicyGrantDetail
Description
The details of the policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy grant is applied to child domain units.
CreateProjectFromProjectProfilePolicyGrantDetail
Description
Specifies whether to create a project from project profile policy grant details.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether to include child domain units when creating a project from project profile policy grant details
- projectProfiles
-
- Type: Array of strings
Specifies project profiles when creating a project from project profile policy grant details
CreateProjectPolicyGrantDetail
Description
The details of the policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy grant is applied to child domain units.
CustomParameter
Description
The details of user parameters of an environment blueprint.
Members
- defaultValue
-
- Type: string
The default value of the parameter.
- description
-
- Type: string
The description of the parameter.
- fieldType
-
- Required: Yes
- Type: string
The filed type of the parameter.
- isEditable
-
- Type: boolean
Specifies whether the parameter is editable.
- isOptional
-
- Type: boolean
Specifies whether the custom parameter is optional.
- keyName
-
- Required: Yes
- Type: string
The key name of the parameter.
DataProductItem
Description
The data product.
Members
- glossaryTerms
-
- Type: Array of strings
The glossary terms of the data product.
- identifier
-
- Required: Yes
- Type: string
The ID of the data product.
- itemType
-
- Required: Yes
- Type: string
The type of the data product.
- revision
-
- Type: string
The revision of the data product.
DataProductListing
Description
The data product listing.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data product listing was created.
- dataProductId
-
- Type: string
The ID of the data product listing.
- dataProductRevision
-
- Type: string
The revision of the data product listing.
- forms
-
- Type: string
The metadata forms of the data product listing.
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms of the data product listing.
- items
-
- Type: Array of ListingSummary structures
The data assets of the data product listing.
- owningProjectId
-
- Type: string
The ID of the owning project of the data product listing.
DataProductListingItem
Description
The asset of the data product listing.
Members
- additionalAttributes
-
- Type: DataProductListingItemAdditionalAttributes structure
The additional attributes of the asset of the data product.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the asset of the data product listing was created.
- description
-
- Type: string
The description of the asset of the asset of the data product.
- entityId
-
- Type: string
The entity ID of the asset of the asset of the data product.
- entityRevision
-
- Type: string
The revision of the asset of the asset of the data product.
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms of the asset of the asset of the data product.
- items
-
- Type: Array of ListingSummaryItem structures
The data of the asset of the data product.
- listingCreatedBy
-
- Type: string
The timestamp at which the listing was created.
- listingId
-
- Type: string
The ID of the listing.
- listingRevision
-
- Type: string
The revision of the listing.
- listingUpdatedBy
-
- Type: string
The user who updated the listing.
- name
-
- Type: string
The name of the asset of the data product.
- owningProjectId
-
- Type: string
The ID of the owning project of the asset of the data product.
DataProductListingItemAdditionalAttributes
Description
The additional attributes of the asset of the data product.
Members
- forms
-
- Type: string
The metadata forms of the asset of the data product.
DataProductResultItem
Description
The data product.
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 first revision of the data product was created.
- firstRevisionCreatedBy
-
- Type: string
The user who created the first revision 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.
- 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.
DataProductRevision
Description
The data product revision.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data product revision was created.
- createdBy
-
- Type: string
The user who created the data product revision.
- domainId
-
- Type: string
The ID of the domain where the data product revision lives.
- id
-
- Type: string
The ID of the data product revision.
- revision
-
- Type: string
The data product revision.
DataSourceConfigurationInput
Description
The configuration of the data source.
Members
- glueRunConfiguration
-
- Type: GlueRunConfigurationInput structure
The configuration of the Amazon Web Services Glue data source.
- redshiftRunConfiguration
-
- Type: RedshiftRunConfigurationInput structure
The configuration of the Amazon Redshift data source.
- sageMakerRunConfiguration
-
- Type: SageMakerRunConfigurationInput structure
The Amazon SageMaker run configuration.
DataSourceConfigurationOutput
Description
The configuration of the data source.
Members
- glueRunConfiguration
-
- Type: GlueRunConfigurationOutput structure
The configuration of the Amazon Web Services Glue data source.
- redshiftRunConfiguration
-
- Type: RedshiftRunConfigurationOutput structure
The configuration of the Amazon Redshift data source.
- sageMakerRunConfiguration
-
- Type: SageMakerRunConfigurationOutput structure
The Amazon SageMaker run configuration.
DataSourceErrorMessage
Description
The details of the error message that is returned if the operation cannot be successfully completed.
Members
- errorDetail
-
- Type: string
The details of the error message that is returned if the operation cannot be successfully completed.
- errorType
-
- Required: Yes
- Type: string
The type of the error message that is returned if the operation cannot be successfully completed.
DataSourceRunActivity
Description
The activity details of the data source run.
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when data source run activity was created.
- dataAssetId
-
- Type: string
The identifier of the asset included in the data source run activity.
- dataAssetStatus
-
- Required: Yes
- Type: string
The status of the asset included in the data source run activity.
- dataSourceRunId
-
- Required: Yes
- Type: string
The identifier of the data source for the data source run activity.
- database
-
- Required: Yes
- Type: string
The database included in the data source run activity.
- errorMessage
-
- Type: DataSourceErrorMessage structure
The details of the error message that is returned if the operation cannot be successfully completed.
- lineageSummary
-
- Type: LineageInfo structure
The data lineage summary.
- projectId
-
- Required: Yes
- Type: string
The project ID included in the data source run activity.
- technicalDescription
-
- Type: string
The technical description included in the data source run activity.
- technicalName
-
- Required: Yes
- Type: string
The technical name included in the data source run activity.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when data source run activity was updated.
DataSourceRunLineageSummary
Description
The run lineage summary of a data source.
Members
- importStatus
-
- Type: string
The import status that's part of the run lineage summary of a data source.
DataSourceRunSummary
Description
The details of a data source run.
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a data source run was created.
- dataSourceId
-
- Required: Yes
- Type: string
The identifier of the data source of the data source run.
- errorMessage
-
- Type: DataSourceErrorMessage structure
The details of the error message that is returned if the operation cannot be successfully completed.
- id
-
- Required: Yes
- Type: string
The identifier of the data source run.
- lineageSummary
-
- Type: DataSourceRunLineageSummary structure
The run lineage summary of a data source.
- projectId
-
- Required: Yes
- Type: string
The project ID of the data source run.
- runStatisticsForAssets
-
- Type: RunStatisticsForAssets structure
The asset statistics from the data source run.
- startedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a data source run was started.
- status
-
- Required: Yes
- Type: string
The status of the data source run.
- stoppedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a data source run was stopped.
- type
-
- Required: Yes
- Type: string
The type of the data source run.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a data source run was updated.
DataSourceSummary
Description
The details of the data source.
Members
- connectionId
-
- Type: string
The connection ID that's part of the data source summary.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source was created.
- dataSourceId
-
- Required: Yes
- Type: string
The ID of the data source.
- description
-
- Type: string
The data source description.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the data source exists.
- enableSetting
-
- Type: string
Specifies whether the data source is enabled.
- environmentId
-
- Type: string
The ID of the environment in which the data source exists.
- lastRunAssetCount
-
- Type: int
The count of the assets created during the last data source run.
- lastRunAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the data source run was last performed.
- lastRunErrorMessage
-
- Type: DataSourceErrorMessage structure
The details of the error message that is returned if the operation cannot be successfully completed.
- lastRunStatus
-
- Type: string
The status of the last data source run.
- name
-
- Required: Yes
- Type: string
The name of the data source.
- schedule
-
- Type: ScheduleConfiguration structure
The details of the schedule of the data source runs.
- status
-
- Required: Yes
- Type: string
The status of the data source.
- type
-
- Required: Yes
- 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.
Deployment
Description
The details of the last deployment of the environment.
Members
- deploymentId
-
- Type: string
The identifier of the last deployment of the environment.
- deploymentStatus
-
- Type: string
The status of the last deployment of the environment.
- deploymentType
-
- Type: string
The type of the last deployment of the environment.
- failureReason
-
- Type: EnvironmentError structure
The failure reason of the last deployment of the environment.
- isDeploymentComplete
-
- Type: boolean
Specifies whether the last deployment of the environment is complete.
- messages
-
- Type: Array of strings
The messages of the last deployment of the environment.
DeploymentProperties
Description
The deployment properties of the Amazon DataZone blueprint.
Members
- endTimeoutMinutes
-
- Type: int
The end timeout of the environment blueprint deployment.
- startTimeoutMinutes
-
- Type: int
The start timeout of the environment blueprint deployment.
DetailedGlossaryTerm
Description
Details of a glossary term attached to the inventory asset.
Members
- name
-
- Type: string
The name of a glossary term attached to the inventory asset.
- shortDescription
-
- Type: string
The shoft description of a glossary term attached to the inventory asset.
DomainSummary
Description
A summary of a Amazon DataZone domain.
Members
- arn
-
- Required: Yes
- Type: string
The ARN of the Amazon DataZone domain.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp of when a Amazon DataZone domain was created.
- description
-
- Type: string
A description of an Amazon DataZone domain.
- domainVersion
-
- Type: string
The domain version.
- id
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
A timestamp of when a Amazon DataZone domain was last updated.
- managedAccountId
-
- Required: Yes
- Type: string
The identifier of the Amazon Web Services account that manages the domain.
- name
-
- Required: Yes
- Type: string
A name of an Amazon DataZone domain.
- portalUrl
-
- Type: string
The data portal URL for the Amazon DataZone domain.
- status
-
- Required: Yes
- Type: string
The status of the Amazon DataZone domain.
DomainUnitFilterForProject
Description
The domain unit filter of the project grant filter.
Members
- domainUnit
-
- Required: Yes
- Type: string
The domain unit ID to use in the filter.
- includeChildDomainUnits
-
- Type: boolean
Specifies whether to include child domain units.
DomainUnitGrantFilter
Description
The grant filter for the domain unit. In the current release of Amazon DataZone, the only supported filter is the allDomainUnitsGrantFilter
.
Members
- allDomainUnitsGrantFilter
-
- Type: AllDomainUnitsGrantFilter structure
Specifies a grant filter containing all domain units.
DomainUnitGroupProperties
Description
The properties of a domain unit group.
Members
- groupId
-
- Type: string
The ID of the domain unit group.
DomainUnitOwnerProperties
Description
The properties of the domain unit owner.
Members
- group
-
- Type: DomainUnitGroupProperties structure
Indicates that the domain unit owner is a group.
- user
-
- Type: DomainUnitUserProperties structure
Indicates that the domain unit owner is a user.
DomainUnitPolicyGrantPrincipal
Description
The domain unit principal to whom the policy is granted.
Members
- domainUnitDesignation
-
- Required: Yes
- Type: string
Specifes the designation of the domain unit users.
- domainUnitGrantFilter
-
- Type: DomainUnitGrantFilter structure
The grant filter for the domain unit.
- domainUnitIdentifier
-
- Type: string
The ID of the domain unit.
DomainUnitSummary
Description
The summary of the domain unit.
Members
- id
-
- Required: Yes
- Type: string
The ID of the domain unit summary.
- name
-
- Required: Yes
- Type: string
The name of the domain unit summary.
DomainUnitTarget
Description
The target for the domain unit.
Members
- domainUnitId
-
- Required: Yes
- Type: string
The ID of the domain unit.
- includeChildDomainUnits
-
- Type: boolean
Specifies whether to apply a rule to the child domain units.
DomainUnitUserProperties
Description
The properties of the domain unit user.
Members
- userId
-
- Type: string
The ID of teh domain unit user.
EnvironmentActionSummary
Description
The details about the specified action configured for an environment. For example, the details of the specified console links for an analytics tool that is available in this environment.
Members
- description
-
- Type: string
The environment action description.
- domainId
-
- Required: Yes
- Type: string
The Amazon DataZone domain ID of the environment action.
- 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.
EnvironmentBlueprintConfigurationItem
Description
The configuration details of an environment blueprint.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when an environment blueprint was created.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which an environment blueprint exists.
- enabledRegions
-
- Type: Array of strings
The enabled Amazon Web Services Regions specified in a blueprint configuration.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The identifier of the environment blueprint.
- environmentRolePermissionBoundary
-
- Type: string
The environment role permission boundary.
- manageAccessRoleArn
-
- Type: string
The ARN of the manage access role specified in the environment blueprint configuration.
- provisioningConfigurations
-
- Type: Array of ProvisioningConfiguration structures
The provisioning configuration of a blueprint.
- provisioningRoleArn
-
- Type: string
The ARN of the provisioning role specified in the environment blueprint configuration.
- regionalParameters
-
- Type: Associative array of custom strings keys (RegionName) to stringss
The regional parameters of the environment blueprint.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment blueprint was updated.
EnvironmentBlueprintSummary
Description
The details of an environment blueprint summary.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when an environment blueprint was created.
- description
-
- Type: string
The description of a blueprint.
- id
-
- Required: Yes
- Type: string
The identifier of the blueprint.
- name
-
- Required: Yes
- Type: string
The name of the blueprint.
- provider
-
- Required: Yes
- Type: string
The provider of the blueprint.
- provisioningProperties
-
- Required: Yes
- Type: ProvisioningProperties structure
The provisioning properties of the blueprint.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the blueprint was enabled.
EnvironmentConfiguration
Description
The configuration of an environment.
Members
- awsAccount
-
- Required: Yes
- Type: AwsAccount structure
The Amazon Web Services account of the environment.
- awsRegion
-
- Required: Yes
- Type: Region structure
The Amazon Web Services Region of the environment.
- configurationParameters
-
- Type: EnvironmentConfigurationParametersDetails structure
The configuration parameters of the environment.
- deploymentMode
-
- Type: string
The deployment mode of the environment.
- deploymentOrder
-
- Type: int
The deployment order of the environment.
- description
-
- Type: string
The environment description.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The environment blueprint ID.
- id
-
- Type: string
The environment ID.
- name
-
- Required: Yes
- Type: string
The environment name.
EnvironmentConfigurationParameter
Description
The environment configuration parameter.
Members
- isEditable
-
- Type: boolean
Specifies whether the environment parameter is editable.
- name
-
- Type: string
The name of the environment configuration parameter.
- value
-
- Type: string
The value of the environment configuration parameter.
EnvironmentConfigurationParametersDetails
Description
The details of the environment configuration parameter.
Members
- parameterOverrides
-
- Type: Array of EnvironmentConfigurationParameter structures
The parameter overrides.
- resolvedParameters
-
- Type: Array of EnvironmentConfigurationParameter structures
The resolved environment configuration parameters.
- ssmPath
-
- Type: string
Ssm path environment configuration parameters.
EnvironmentConfigurationUserParameter
Description
The environment configuration user parameters.
Members
- environmentConfigurationName
-
- Type: string
The environment configuration name.
- environmentParameters
-
- Type: Array of EnvironmentParameter structures
The environment parameters.
EnvironmentDeploymentDetails
Description
The environment deployment details.
Members
- environmentFailureReasons
-
- Type: Associative array of custom strings keys (String) to EnvironmentError structuress
Environment failure reasons.
- overallDeploymentStatus
-
- Type: string
The overall deployment status of the environment.
EnvironmentError
Description
The failure reasons for the environment deployment.
Members
- code
-
- Type: string
The error code for the failure reason for the environment deployment.
- message
-
- Required: Yes
- Type: string
The error message for the failure reason for the environment deployment.
EnvironmentParameter
Description
The parameter details of an evironment profile.
Members
- name
-
- Type: string
The name of an environment profile parameter.
- value
-
- Type: string
The value of an environment profile parameter.
EnvironmentProfileSummary
Description
The details of an environment profile.
Members
- awsAccountId
-
- Type: string
The identifier of an Amazon Web Services account in which an environment profile exists.
- awsAccountRegion
-
- Type: string
The Amazon Web Services Region in which an environment profile exists.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when an environment profile was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the environment profile.
- description
-
- Type: string
The description of the environment profile.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the environment profile exists.
- environmentBlueprintId
-
- Required: Yes
- Type: string
The identifier of a blueprint with which an environment profile is created.
- id
-
- Required: Yes
- Type: string
The identifier of the environment profile.
- name
-
- Required: Yes
- Type: string
The name of the environment profile.
- projectId
-
- Type: string
The identifier of a project in which an environment profile exists.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment profile was updated.
EnvironmentSummary
Description
The details of an environment.
Members
- awsAccountId
-
- Type: string
The identifier of the Amazon Web Services account in which an environment exists.
- awsAccountRegion
-
- Type: string
The Amazon Web Services Region in which an 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.
- description
-
- Type: string
The description of the environment.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the environment exists.
- environmentProfileId
-
- Type: string
The identifier of the environment profile with which the environment was created.
- id
-
- Type: string
The identifier of the environment.
- name
-
- Required: Yes
- Type: string
The name of the environment.
- projectId
-
- Required: Yes
- Type: string
The identifier of the project in which the environment exists.
- provider
-
- Required: Yes
- Type: string
The provider of the environment.
- status
-
- Type: string
The status of the environment.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the environment was updated.
EqualToExpression
Description
Specifies whether the value is equal to an expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might be equal to an expression.
EventSummary
Description
The event summary.
Members
- openLineageRunEventSummary
-
- Type: OpenLineageRunEventSummary structure
The open lineage run event summary.
FailureCause
Description
Specifies the error message that is returned if the operation cannot be successfully completed.
Members
- message
-
- Type: string
The description of the error message.
Filter
Description
A search filter in Amazon DataZone.
Members
- attribute
-
- Required: Yes
- Type: string
A search filter attribute in Amazon DataZone.
- value
-
- Required: Yes
- Type: string
A search filter value in Amazon DataZone.
FilterClause
Description
A search filter clause in Amazon DataZone.
Members
- and
-
- Type: Array of FilterClause structures
The 'and' search filter clause in Amazon DataZone.
- filter
-
- Type: Filter structure
A search filter in Amazon DataZone.
- or
-
- Type: Array of FilterClause structures
The 'or' search filter clause in Amazon DataZone.
FilterExpression
Description
A filter expression in Amazon DataZone.
Members
- expression
-
- Required: Yes
- Type: string
The search filter expression.
- type
-
- Required: Yes
- Type: string
The search filter explresison type.
FormEntryInput
Description
The details of the form entry.
Members
- required
-
- Type: boolean
Specifies whether a form entry is required.
- typeIdentifier
-
- Required: Yes
- Type: string
The type ID of the form entry.
- typeRevision
-
- Required: Yes
- Type: string
The type revision of the form entry.
FormEntryOutput
Description
The details of the form entry.
Members
- required
-
- Type: boolean
Specifies whether a form entry is required.
- typeName
-
- Required: Yes
- Type: string
The name of the type of the form entry.
- typeRevision
-
- Required: Yes
- Type: string
The type revision of the form entry.
FormInput
Description
The details of a metadata form.
Members
- content
-
- Type: string
The content of the metadata form.
- formName
-
- Required: Yes
- Type: string
The name of the metadata form.
- typeIdentifier
-
- Type: string
The ID of the metadata form type.
- typeRevision
-
- Type: string
The revision of the metadata form type.
FormOutput
Description
The details of a metadata form.
Members
- content
-
- Type: string
The content of the metadata form.
- formName
-
- Required: Yes
- Type: string
The name of the metadata form.
- typeName
-
- Type: string
The name of the metadata form type.
- typeRevision
-
- Type: string
The revision of the metadata form type.
FormTypeData
Description
The details of the metadata form type.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the metadata form type was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created teh metadata form type.
- description
-
- Type: string
The description of the metadata form type.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the form type exists.
- imports
-
- Type: Array of Import structures
The imports specified in the form type.
- model
-
- Type: Model structure
The model of the form type.
- name
-
- Required: Yes
- Type: string
The name of the form type.
- originDomainId
-
- Type: string
The identifier of the Amazon DataZone domain in which the form type was originally created.
- originProjectId
-
- Type: string
The identifier of the project in which the form type was originally created.
- owningProjectId
-
- Type: string
The identifier of the project that owns the form type.
- revision
-
- Required: Yes
- Type: string
The revision of the form type.
- status
-
- Type: string
The status of the form type.
GlossaryItem
Description
The details of a business glossary.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the glossary was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created the glossary.
- description
-
- Type: string
The business glossary description.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the business glossary exists.
- id
-
- Required: Yes
- Type: string
The identifier of the glossary.
- name
-
- Required: Yes
- Type: string
The name of the glossary.
- owningProjectId
-
- Required: Yes
- Type: string
The identifier of the project that owns the business glosary.
- status
-
- Required: Yes
- Type: string
The business glossary status.
- 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.
GlossaryTermItem
Description
The details of a business glossary term.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a business glossary term was created.
- createdBy
-
- Type: string
The Amazon DataZone user who created the business glossary.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which the business glossary exists.
- glossaryId
-
- Required: Yes
- Type: string
The identifier of the business glossary to which the term belongs.
- id
-
- Required: Yes
- Type: string
The identifier 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 description 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 a business glossary term was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the business glossary term.
GlueConnection
Description
The Amazon Web Services Glue connection.
Members
- athenaProperties
-
- Type: Associative array of custom strings keys (PropertyMapKeyString) to strings
The Amazon Athena properties of the Amazon Web Services Glue connection.
- authenticationConfiguration
-
- Type: AuthenticationConfiguration structure
The authentication configuration of the Amazon Web Services Glue connection.
- compatibleComputeEnvironments
-
- Type: Array of strings
The compatible compute environments of the Amazon Web Services Glue connection.
- connectionProperties
-
- Type: Associative array of custom strings keys (String) to strings
The properties of the Amazon Web Services Glue connection.
- connectionSchemaVersion
-
- Type: int
The connection schema version of the Amazon Web Services Glue connection.
- connectionType
-
- Type: string
The type of the Amazon Web Services Glue connection.
- creationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The creation time of the Amazon Web Services Glue connection.
- description
-
- Type: string
The description of the Amazon Web Services Glue connection.
- lastConnectionValidationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The last validation time of the Amazon Web Services Glue connection.
- lastUpdatedBy
-
- Type: string
The user who last updated the Amazon Web Services Glue connection.
- lastUpdatedTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the Amazon Web Services Glue connection was last updated.
- matchCriteria
-
- Type: Array of strings
The match criteria of the Amazon Web Services Glue connection.
- name
-
- Type: string
The name of the Amazon Web Services Glue connection.
- physicalConnectionRequirements
-
- Type: PhysicalConnectionRequirements structure
The physical connection requirements of the Amazon Web Services Glue connection.
- pythonProperties
-
- Type: Associative array of custom strings keys (PropertyMapKeyString) to strings
The Python properties of the Amazon Web Services Glue connection.
- sparkProperties
-
- Type: Associative array of custom strings keys (PropertyMapKeyString) to strings
The Spark properties of the Amazon Web Services Glue connection.
- status
-
- Type: string
The status of the Amazon Web Services Glue connection.
- statusReason
-
- Type: string
The status reason of the Amazon Web Services Glue connection.
GlueConnectionInput
Description
The Amazon Web Services Glue connecton input.
Members
- athenaProperties
-
- Type: Associative array of custom strings keys (PropertyMapKeyString) to strings
The Amazon Athena properties of the Amazon Web Services Glue connection.
- authenticationConfiguration
-
- Type: AuthenticationConfigurationInput structure
The authentication configuration of the Amazon Web Services Glue connection.
- connectionProperties
-
- Type: Associative array of custom strings keys (String) to strings
The connection properties of the Amazon Web Services Glue connection.
- connectionType
-
- Type: string
The connection type of the Amazon Web Services Glue connection.
- description
-
- Type: string
The description of the Amazon Web Services Glue connection.
- matchCriteria
-
- Type: string
The match criteria of the Amazon Web Services Glue connection.
- name
-
- Type: string
The name of the Amazon Web Services Glue connection.
- physicalConnectionRequirements
-
- Type: PhysicalConnectionRequirements structure
The physical connection requirements for the Amazon Web Services Glue connection.
- pythonProperties
-
- Type: Associative array of custom strings keys (PropertyMapKeyString) to strings
The Python properties of the Amazon Web Services Glue connection.
- sparkProperties
-
- Type: Associative array of custom strings keys (PropertyMapKeyString) to strings
The Spark properties of the Amazon Web Services Glue connection.
- validateCredentials
-
- Type: boolean
Speciefies whether to validate credentials of the Amazon Web Services Glue connection.
- validateForComputeEnvironments
-
- Type: Array of strings
Speciefies whether to validate for compute environments of the Amazon Web Services Glue connection.
GlueConnectionPatch
Description
The Amazon Web Services Glue connection patch.
Members
- authenticationConfiguration
-
- Type: AuthenticationConfigurationPatch structure
The authentication configuration of the Amazon Web Services Glue connection patch.
- connectionProperties
-
- Type: Associative array of custom strings keys (String) to strings
The properties of the Amazon Web Services Glue connection patch.
- description
-
- Type: string
The description of the Amazon Web Services Glue connection patch.
GlueOAuth2Credentials
Description
The GlueOAuth2 credentials of a connection.
Members
- accessToken
-
- Type: string
The access token of a connection.
- jwtToken
-
- Type: string
The jwt token of the connection.
- refreshToken
-
- Type: string
The refresh token of the connection.
- userManagedClientApplicationClientSecret
-
- Type: string
The user managed client application client secret of the connection.
GluePropertiesInput
Description
The Amazon Web Services Glue properties of a connection.
Members
- glueConnectionInput
-
- Type: GlueConnectionInput structure
The Amazon Web Services Glue connection.
GluePropertiesOutput
Description
The properties of the Amazon Web Services Glue connection.
Members
- errorMessage
-
- Type: string
The error message generated if the action is not completed successfully.
- status
-
- Type: string
The status of a connection.
GluePropertiesPatch
Description
The Amazon Web Services Glue properties patch of a connection.
Members
- glueConnectionInput
-
- Type: GlueConnectionPatch structure
The Amazon Web Services Glue properties patch of a connection.
GlueRunConfigurationInput
Description
The configuration details of the Amazon Web Services Glue data source.
Members
- autoImportDataQualityResult
-
- Type: boolean
Specifies whether to automatically import data quality metrics as part of the data source run.
- catalogName
-
- Type: string
The catalog name in the Amazon Web Services Glue run configuration.
- dataAccessRole
-
- Type: string
The data access role included in the configuration details of the Amazon Web Services Glue data source.
- relationalFilterConfigurations
-
- Required: Yes
- Type: Array of RelationalFilterConfiguration structures
The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.
GlueRunConfigurationOutput
Description
The configuration details of the Amazon Web Services Glue data source.
Members
- accountId
-
- Type: string
The Amazon Web Services account ID included in the configuration details of the Amazon Web Services Glue data source.
- autoImportDataQualityResult
-
- Type: boolean
Specifies whether to automatically import data quality metrics as part of the data source run.
- catalogName
-
- Type: string
The catalog name in the Amazon Web Services Glue run configuration.
- dataAccessRole
-
- Type: string
The data access role included in the configuration details of the Amazon Web Services Glue data source.
- region
-
- Type: string
The Amazon Web Services region included in the configuration details of the Amazon Web Services Glue data source.
- relationalFilterConfigurations
-
- Required: Yes
- Type: Array of RelationalFilterConfiguration structures
The relational filter configurations included in the configuration details of the Amazon Web Services Glue data source.
GlueSelfGrantStatusOutput
Description
The details of the self granting status.
Members
- selfGrantStatusDetails
-
- Required: Yes
- Type: Array of SelfGrantStatusDetail structures
The details for the self granting status for a Glue data source.
GrantedEntity
Description
The details of a listing for which a subscription is granted.
Members
- listing
-
- Type: ListingRevision structure
The listing for which a subscription is granted.
GrantedEntityInput
Description
The details of a listing for which a subscription is to be granted.
Members
- listing
-
- Type: ListingRevisionInput structure
The listing for which a subscription is to be granted.
GreaterThanExpression
Description
Specifies whether the value is greater than an expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might be greater than an expression.
GreaterThanOrEqualToExpression
Description
Specifies whether the value is greater than or equal to an expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might be greater than or equal to an expression.
GroupDetails
Description
The details of a group in Amazon DataZone.
Members
- groupId
-
- Required: Yes
- Type: string
The identifier of the group in Amazon DataZone.
GroupPolicyGrantPrincipal
Description
The group principal to whom the policy is granted.
Members
- groupIdentifier
-
- Type: string
The ID Of the group of the group principal.
GroupProfileSummary
Description
The details of a group profile.
Members
- domainId
-
- Type: string
The ID of the Amazon DataZone domain of a group profile.
- groupName
-
- Type: string
The group name of a group profile.
- id
-
- Type: string
The ID of a group profile.
- status
-
- Type: string
The status of a group profile.
HyperPodPropertiesInput
Description
The hyper pod properties of a Amazon Web Services Glue properties patch.
Members
- clusterName
-
- Required: Yes
- Type: string
The cluster name the hyper pod properties.
HyperPodPropertiesOutput
Description
The hyper pod properties of a Amazon Web Services Glue properties patch.
Members
- clusterArn
-
- Type: string
The cluster ARN of the hyper pod properties.
- clusterName
-
- Required: Yes
- Type: string
The cluster name the hyper pod properties.
- orchestrator
-
- Type: string
The orchestrator of the hyper pod properties.
IamPropertiesInput
Description
The IAM properties of a connection.
Members
- glueLineageSyncEnabled
-
- Type: boolean
Specifies whether Amazon Web Services Glue lineage sync is enabled for a connection.
IamPropertiesOutput
Description
The IAM properties of a connection.
Members
- environmentId
-
- Type: string
The environment ID of the connection.
- glueLineageSyncEnabled
-
- Type: boolean
Specifies whether Amazon Web Services Glue lineage sync is enabled for a connection.
IamPropertiesPatch
Description
The IAM properties patch of a connection.
Members
- glueLineageSyncEnabled
-
- Type: boolean
Specifies whether Amazon Web Services Glue lineage sync is enabled for a connection.
IamUserProfileDetails
Description
The details of an IAM user profile in Amazon DataZone.
Members
- arn
-
- Type: string
The ARN of an IAM user profile in Amazon DataZone.
Import
Description
The details of the import of the metadata form type.
Members
- name
-
- Required: Yes
- Type: string
The name of the import.
- revision
-
- Required: Yes
- Type: string
The revision of the import.
InExpression
Description
Specifies whether values are in the expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- values
-
- Required: Yes
- Type: Array of strings
The values that might be in the expression.
InternalServerException
Description
The request has failed because of an unknown error, exception or failure.
Members
- message
-
- Required: Yes
- Type: string
IsNotNullExpression
Description
Specifies that the expression is not null.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
IsNullExpression
Description
Specifies that the expression is null.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
JobRunDetails
Description
The details of a job run.
Members
- lineageRunDetails
-
- Type: LineageRunDetails structure
The data lineage details of a job run.
JobRunError
Description
The job run error.
Members
- message
-
- Required: Yes
- Type: string
The job run error message.
JobRunSummary
Description
The job run summary.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which job run was created.
- createdBy
-
- Type: string
The user who created the job run.
- domainId
-
- Type: string
The domain ID of the job run.
- endTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The end time of a job run.
- error
-
- Type: JobRunError structure
The error of a job run.
- jobId
-
- Type: string
The job ID of a job run.
- jobType
-
- Type: string
The job type of a job run.
- runId
-
- Type: string
The run ID of a job run.
- runMode
-
- Type: string
The run mode of a job run.
- startTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The start time of a job run.
- status
-
- Type: string
The status of a job run.
LakeFormationConfiguration
Description
The Lake Formation configuration of the Data Lake blueprint.
Members
- locationRegistrationExcludeS3Locations
-
- Type: Array of strings
Specifies certain Amazon S3 locations if you do not want Amazon DataZone to automatically register them in hybrid mode.
- locationRegistrationRole
-
- Type: string
The role that is used to manage read/write access to the chosen Amazon S3 bucket(s) for Data Lake using AWS Lake Formation hybrid access mode.
LessThanExpression
Description
Specifies that a value is less than an expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might be less than the expression.
LessThanOrEqualToExpression
Description
Specifies that a value is less than or equal to an expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might be less than or equal to an expression.
LikeExpression
Description
Specifies that a value is like the expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might be like the expression.
LineageEventSummary
Description
The data lineage event summary.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which data lineage event was created.
- createdBy
-
- Type: string
The user who created the data lineage event.
- domainId
-
- Type: string
The domain ID of the lineage event.
- eventSummary
-
- Type: EventSummary structure
The summary of the data lineate event.
- eventTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time of the data lineage event.
- id
-
- Type: string
The ID of the data lineage event.
- processingStatus
-
- Type: string
The processing status of the data lineage event.
LineageInfo
Description
The data lineage information.
Members
- errorMessage
-
- Type: string
The data lineage error message.
- eventId
-
- Type: string
The data lineage event ID.
- eventStatus
-
- Type: string
The data lineage event status.
LineageNodeReference
Description
The reference details for the data lineage node.
Members
- eventTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The event timestamp of the data lineage node.
- id
-
- Type: string
The ID of the data lineage node.
LineageNodeSummary
Description
The summary of the data lineage node.
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 of the data lineage node.
- eventTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The event timestamp of the 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 alternate ID of the data lineage node.
- typeName
-
- Required: Yes
- Type: string
The name of the type of the data lineage node.
- typeRevision
-
- Type: string
The type of the revision of the 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.
LineageNodeTypeItem
Description
The details of a data lineage node type.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data lineage node type was created.
- createdBy
-
- Type: string
The user who created the data lineage node type.
- description
-
- Type: string
The description of the data lineage node type.
- domainId
-
- Required: Yes
- Type: string
The ID of the domain where the data lineage node type lives.
- formsOutput
-
- Required: Yes
- Type: Associative array of custom strings keys (FormName) to FormEntryOutput structures
The forms output of the data lineage node type.
- name
-
- Type: string
The name of the data lineage node type.
- revision
-
- Required: Yes
- Type: string
The revision of the data lineage node type.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the data lineage node type was updated.
- updatedBy
-
- Type: string
The user who updated the data lineage node type.
LineageRunDetails
Description
The data lineage run details.
Members
- sqlQueryRunDetails
-
- Type: LineageSqlQueryRunDetails structure
The SQL query run details of a data lineage run.
LineageSqlQueryRunDetails
Description
The SQL query run details of a data lineage run.
Members
- errorMessages
-
- Type: Array of strings
The error message of the SQL query run details of a data lineage run.
- numQueriesFailed
-
- Type: int
The number of queries that failed in the SQL query run details of a data lineage run.
- queryEndTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The query end time in the SQL query run details of a data lineage run.
- queryStartTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The query start time in the SQL query run details of a data lineage run.
- totalQueriesProcessed
-
- Type: int
The total queries processed in the SQL query run details of a data lineage run.
LineageSyncSchedule
Description
The lineage sync schedule.
Members
- schedule
-
- Type: string
The lineage sync schedule.
ListingItem
Description
The details of a listing (aka asset published in a Amazon DataZone catalog).
Members
- assetListing
-
- Type: AssetListing structure
An asset published in an Amazon DataZone catalog.
- dataProductListing
-
- Type: DataProductListing structure
The data product listing.
ListingRevision
Description
A revision of an asset published in a Amazon DataZone catalog.
Members
- id
-
- Required: Yes
- Type: string
An identifier of a revision of an asset published in a Amazon DataZone catalog.
- revision
-
- Required: Yes
- Type: string
The details of a revision of an asset published in a Amazon DataZone catalog.
ListingRevisionInput
Description
A revision to be made to an asset published in a Amazon DataZone catalog.
Members
- identifier
-
- Required: Yes
- Type: string
An identifier of revision to be made to an asset published in a Amazon DataZone catalog.
- revision
-
- Required: Yes
- Type: string
The details of a revision to be made to an asset published in a Amazon DataZone catalog.
ListingSummary
Description
The summary of the listing of the data product.
Members
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms of the data product.
- listingId
-
- Type: string
The ID of the data product listing.
- listingRevision
-
- Type: string
The revision of the data product listing.
ListingSummaryItem
Description
The results of the data product summary.
Members
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms of the data product listing.
- listingId
-
- Type: string
The ID of the data product listing.
- listingRevision
-
- Type: string
The revision of the data product listing.
Member
Description
The details about a project member.
Members
- groupIdentifier
-
- Type: string
The ID of the group of a project member.
- userIdentifier
-
- Type: string
The user ID of a project member.
MemberDetails
Description
The details about a project member.
Members
- group
-
- Type: GroupDetails structure
The group details of a project member.
- user
-
- Type: UserDetails structure
The user details of a project member.
MetadataFormEnforcementDetail
Description
The enforcement details of a metadata form.
Members
- requiredMetadataForms
-
- Type: Array of MetadataFormReference structures
The required metadata forms.
MetadataFormReference
Description
The reference of a metadata form.
Members
- typeIdentifier
-
- Required: Yes
- Type: string
The type ID of the metadata form reference.
- typeRevision
-
- Required: Yes
- Type: string
The type revision of the metadata form reference.
MetadataFormSummary
Description
The summary of the metadata form.
Members
- formName
-
- Type: string
The form name of the metadata form.
- typeName
-
- Required: Yes
- Type: string
The type name of the metadata form.
- typeRevision
-
- Required: Yes
- Type: string
The type revision of the metadata form.
MetadataGenerationRunItem
Description
The metadata generation run.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the metadata generation run was created.
- createdBy
-
- Type: string
The user who created the metadata generation run.
- domainId
-
- Required: Yes
- Type: string
The ID of the Amazon DataZone domain in which the metadata generation run was created.
- 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 asset for which the metadata generation was ran.
- status
-
- Type: string
The status of the metadata generation run.
- target
-
- Type: MetadataGenerationRunTarget structure
The asset for which metadata was generated.
- type
-
- Type: string
The type of the metadata generation run.
MetadataGenerationRunTarget
Description
The asset for which metadata was generated.
Members
- identifier
-
- Required: Yes
- Type: string
The ID of the metadata generation run's target.
- revision
-
- Type: string
The revision of the asset for which metadata was generated.
- type
-
- Required: Yes
- Type: string
The type of the asset for which metadata was generated.
Model
Description
The model of the API.
Members
- smithy
-
- Type: string
Indicates the smithy model of the API.
NameIdentifier
Description
The name identifier.
Members
- name
-
- Type: string
The name in the name identifier.
- namespace
-
- Type: string
The namespace in the name identifier.
NotEqualToExpression
Description
Specifies that a value is not equal to the expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might not be equal to the expression.
NotInExpression
Description
Specifies that a value is not in the expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- values
-
- Required: Yes
- Type: Array of strings
The value that might not be in the expression.
NotLikeExpression
Description
Specifies that a value might be not like the expression.
Members
- columnName
-
- Required: Yes
- Type: string
The name of the column.
- value
-
- Required: Yes
- Type: string
The value that might not be like the expression.
NotificationOutput
Description
The details of a notification generated in Amazon DataZone.
Members
- actionLink
-
- Required: Yes
- Type: string
The action link included in the notification.
- creationTimestamp
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a notification was created.
- domainIdentifier
-
- Required: Yes
- Type: string
The identifier of a Amazon DataZone domain in which the notification exists.
- identifier
-
- Required: Yes
- Type: string
The identifier of the notification.
- lastUpdatedTimestamp
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the notification was last updated.
- message
-
- Required: Yes
- Type: string
The message included in the notification.
- metadata
-
- Type: Associative array of custom strings keys (String) to strings
The metadata included in the notification.
- status
-
- Type: string
The status included in the notification.
- title
-
- Required: Yes
- Type: string
The title of the notification.
- topic
-
- Required: Yes
- Type: Topic structure
The topic of the notification.
- type
-
- Required: Yes
- Type: string
The type of the notification.
NotificationResource
Description
The details of the resource mentioned in a notification.
Members
- id
-
- Required: Yes
- Type: string
The ID of the resource mentioned in a notification.
- name
-
- Type: string
The name of the resource mentioned in a notification.
- type
-
- Required: Yes
- Type: string
The type of the resource mentioned in a notification.
OAuth2ClientApplication
Description
The OAuth2Client application.
Members
- aWSManagedClientApplicationReference
-
- Type: string
The Amazon Web Services managed client application reference in the OAuth2Client application.
- userManagedClientApplicationClientId
-
- Type: string
The user managed client application client ID in the OAuth2Client application.
OAuth2Properties
Description
The OAuth2 properties.
Members
- authorizationCodeProperties
-
- Type: AuthorizationCodeProperties structure
The authorization code properties of the OAuth2 properties.
- oAuth2ClientApplication
-
- Type: OAuth2ClientApplication structure
The OAuth2 client application of the OAuth2 properties.
- oAuth2Credentials
-
- Type: GlueOAuth2Credentials structure
The OAuth2 credentials of the OAuth2 properties.
- oAuth2GrantType
-
- Type: string
The OAuth2 grant type of the OAuth2 properties.
- tokenUrl
-
- Type: string
The OAuth2 token URL of the OAuth2 properties.
- tokenUrlParametersMap
-
- Type: Associative array of custom strings keys (TokenUrlParametersMapKeyString) to strings
The OAuth2 token URL parameter map of the OAuth2 properties.
OpenLineageRunEventSummary
Description
The open lineage run event summary.
Members
- eventType
-
- Type: string
The event type of the open lineage run event summary.
- inputs
-
- Type: Array of NameIdentifier structures
The inputs of the open lineage run event summary.
- job
-
- Type: NameIdentifier structure
The job of the open lineage run event summary.
- outputs
-
- Type: Array of NameIdentifier structures
The outputs of the open lineage run event summary.
- runId
-
- Type: string
The runID of the open lineage run event summary.
OverrideDomainUnitOwnersPolicyGrantDetail
Description
The grant details of the override domain unit owners policy.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy is inherited by child domain units.
OverrideProjectOwnersPolicyGrantDetail
Description
The details of the override project owners policy grant.
Members
- includeChildDomainUnits
-
- Type: boolean
Specifies whether the policy is inherited by child domain units.
OwnerGroupProperties
Description
The properties of the domain unit owners group.
Members
- groupIdentifier
-
- Required: Yes
- Type: string
The ID of the domain unit owners group.
OwnerGroupPropertiesOutput
Description
The properties of the domain unit owners group.
Members
- groupId
-
- Type: string
The ID of the domain unit owners group.
OwnerProperties
Description
The properties of a domain unit's owner.
Members
- group
-
- Type: OwnerGroupProperties structure
Specifies that the domain unit owner is a group.
- user
-
- Type: OwnerUserProperties structure
Specifies that the domain unit owner is a user.
OwnerPropertiesOutput
Description
The ID of the domain unit owners group.
Members
- group
-
- Type: OwnerGroupPropertiesOutput structure
Specifies that the domain unit owner is a group.
- user
-
- Type: OwnerUserPropertiesOutput structure
Specifies that the domain unit owner is a user.
OwnerUserProperties
Description
The properties of the owner user.
Members
- userIdentifier
-
- Required: Yes
- Type: string
The ID of the owner user.
OwnerUserPropertiesOutput
Description
The properties of the owner user.
Members
- userId
-
- Type: string
The ID of the owner user.
PhysicalConnectionRequirements
Description
Physical connection requirements of a connection.
Members
- availabilityZone
-
- Type: string
The availability zone of the physical connection requirements of a connection.
- securityGroupIdList
-
- Type: Array of strings
The group ID list of the physical connection requirements of a connection.
- subnetId
-
- Type: string
The subnet ID of the physical connection requirements of a connection.
- subnetIdList
-
- Type: Array of strings
The subnet ID list of the physical connection requirements of a connection.
PhysicalEndpoint
Description
The physical endpoints of a connection.
Members
- awsLocation
-
- Type: AwsLocation structure
The location of a connection.
- glueConnection
-
- Type: GlueConnection structure
The Amazon Web Services Glue connection.
- glueConnectionName
-
- Type: string
The Amazon Web Services Glue connection name.
- host
-
- Type: string
The host in the physical endpoints of a connection.
- port
-
- Type: int
The port in the physical endpoints of a connection.
- protocol
-
- Type: string
The protocol in the physical endpoints of a connection.
- stage
-
- Type: string
The stage in the physical endpoints of a connection.
PolicyGrantDetail
Description
The details of the policy grant.
Members
- addToProjectMemberPool
-
- Type: AddToProjectMemberPoolPolicyGrantDetail structure
Specifies that the policy grant is to be added to the members of the project.
- createAssetType
-
- Type: CreateAssetTypePolicyGrantDetail structure
Specifies that this is a create asset type policy.
- createDomainUnit
-
- Type: CreateDomainUnitPolicyGrantDetail structure
Specifies that this is a create domain unit policy.
- createEnvironment
-
- Type: Unit structure
Specifies that this is a create environment policy.
- createEnvironmentFromBlueprint
-
- Type: Unit structure
The details of the policy of creating an environment.
- createEnvironmentProfile
-
- Type: CreateEnvironmentProfilePolicyGrantDetail structure
Specifies that this is a create environment profile policy.
- createFormType
-
- Type: CreateFormTypePolicyGrantDetail structure
Specifies that this is a create form type policy.
- createGlossary
-
- Type: CreateGlossaryPolicyGrantDetail structure
Specifies that this is a create glossary policy.
- createProject
-
- Type: CreateProjectPolicyGrantDetail structure
Specifies that this is a create project policy.
- createProjectFromProjectProfile
-
- Type: CreateProjectFromProjectProfilePolicyGrantDetail structure
Specifies whether to create a project from project profile.
- delegateCreateEnvironmentProfile
-
- Type: Unit structure
Specifies that this is the delegation of the create environment profile policy.
- overrideDomainUnitOwners
-
- Type: OverrideDomainUnitOwnersPolicyGrantDetail structure
Specifies whether to override domain unit owners.
- overrideProjectOwners
-
- Type: OverrideProjectOwnersPolicyGrantDetail structure
Specifies whether to override project owners.
PolicyGrantMember
Description
A member of the policy grant list.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Specifies the timestamp at which policy grant member was created.
- createdBy
-
- Type: string
Specifies the user who created the policy grant member.
- detail
-
- Type: PolicyGrantDetail structure
The details of the policy grant member.
- principal
-
- Type: PolicyGrantPrincipal structure
The principal of the policy grant member.
PolicyGrantPrincipal
Description
The policy grant principal.
Members
- domainUnit
-
- Type: DomainUnitPolicyGrantPrincipal structure
The domain unit of the policy grant principal.
- group
-
- Type: GroupPolicyGrantPrincipal structure
The group of the policy grant principal.
- project
-
- Type: ProjectPolicyGrantPrincipal structure
The project of the policy grant principal.
- user
-
- Type: UserPolicyGrantPrincipal structure
The user of the policy grant principal.
PredictionConfiguration
Description
The configuration of the prediction.
Members
- businessNameGeneration
-
- Type: BusinessNameGenerationConfiguration structure
The business name generation mechanism.
ProjectDeletionError
Description
Specifies the error message that is returned if the operation cannot be successfully completed.
Members
- code
-
- Type: string
The code of the project deletion error.
- message
-
- Type: string
The message of the project deletion error.
ProjectGrantFilter
Description
The project grant filter.
Members
- domainUnitFilter
-
- Type: DomainUnitFilterForProject structure
The domain unit filter of the project grant filter.
ProjectMember
Description
The details of a project member.
Members
- designation
-
- Required: Yes
- Type: string
The designated role of a project member.
- memberDetails
-
- Required: Yes
- Type: MemberDetails structure
The membership details of a project member.
ProjectPolicyGrantPrincipal
Description
The project policy grant principal.
Members
- projectDesignation
-
- Required: Yes
- Type: string
The project designation of the project policy grant principal.
- projectGrantFilter
-
- Type: ProjectGrantFilter structure
The project grant filter of the project policy grant principal.
- projectIdentifier
-
- Type: string
The project ID of the project policy grant principal.
ProjectProfileSummary
Description
The summary of a project profile.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project profile was created.
- createdBy
-
- Required: Yes
- Type: string
The user who created the project profile.
- description
-
- Type: string
The description of the project profile.
- domainId
-
- Required: Yes
- Type: string
The domain ID of the project profile.
- domainUnitId
-
- Type: string
The domain unit ID of the project profile.
- id
-
- Required: Yes
- Type: string
The ID of the project profile.
- lastUpdatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which a project profile was last updated.
- name
-
- Required: Yes
- Type: string
The name of a project profile.
- status
-
- Type: string
The status of a project profile.
ProjectSummary
Description
The details of a Amazon DataZone project.
Members
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a project was created.
- createdBy
-
- Required: Yes
- Type: string
The Amazon DataZone user who created the project.
- description
-
- Type: string
The description of a project.
- domainId
-
- Required: Yes
- Type: string
The identifier of a Amazon DataZone domain where 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.
- id
-
- Required: Yes
- Type: string
The identifier of a project.
- name
-
- Required: Yes
- Type: string
The name of a project.
- projectStatus
-
- Type: string
The status of the project.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the project was updated.
ProjectsForRule
Description
Specifies projects in which the rule is created.
Members
- selectionMode
-
- Required: Yes
- Type: string
The selection mode of the rule.
- specificProjects
-
- Type: Array of strings
The specific projects in which the rule is created.
ProvisioningConfiguration
Description
The provisioning configuration of the blueprint.
Members
- lakeFormationConfiguration
-
- Type: LakeFormationConfiguration structure
The Lake Formation configuration of the Data Lake blueprint.
ProvisioningProperties
Description
The provisioning properties of an environment blueprint.
Members
- cloudFormation
-
- Type: CloudFormationProperties structure
The cloud formation properties included as part of the provisioning properties of an environment blueprint.
RecommendationConfiguration
Description
The recommendation to be updated as part of the UpdateDataSource
action.
Members
- enableBusinessNameGeneration
-
- Type: boolean
Specifies whether automatic business name generation is to be enabled or not as part of the recommendation configuration.
RedshiftClusterStorage
Description
The details of the Amazon Redshift cluster storage.
Members
- clusterName
-
- Required: Yes
- Type: string
The name of an Amazon Redshift cluster.
RedshiftCredentialConfiguration
Description
The details of the credentials required to access an Amazon Redshift cluster.
Members
- secretManagerArn
-
- Required: Yes
- Type: string
The ARN of a secret manager for an Amazon Redshift cluster.
RedshiftCredentials
Description
Amazon Redshift credentials of a connection.
Members
- secretArn
-
- Type: string
The secret ARN of the Amazon Redshift credentials of a connection.
- usernamePassword
-
- Type: UsernamePassword structure
The username and password of the Amazon Redshift credentials of a connection.
RedshiftLineageSyncConfigurationInput
Description
The Amaon Redshift lineage sync configuration.
Members
- enabled
-
- Type: boolean
Specifies whether the Amaon Redshift lineage sync configuration is enabled.
- schedule
-
- Type: LineageSyncSchedule structure
The schedule of the Amaon Redshift lineage sync configuration.
RedshiftLineageSyncConfigurationOutput
Description
The Amaon Redshift lineage sync configuration.
Members
- enabled
-
- Type: boolean
Specifies whether the Amaon Redshift lineage sync configuration is enabled.
- lineageJobId
-
- Type: string
The lineage job ID of the Amaon Redshift lineage sync configuration.
- schedule
-
- Type: LineageSyncSchedule structure
The schedule of teh Amaon Redshift lineage sync configuration.
RedshiftPropertiesInput
Description
The Amazon Redshift properties.
Members
- credentials
-
- Type: RedshiftCredentials structure
The Amaon Redshift credentials.
- databaseName
-
- Type: string
The Amazon Redshift database name.
- host
-
- Type: string
The Amazon Redshift host.
- lineageSync
-
- Type: RedshiftLineageSyncConfigurationInput structure
The lineage sync of the Amazon Redshift.
- port
-
- Type: int
The Amaon Redshift port.
- storage
-
- Type: RedshiftStorageProperties structure
The Amazon Redshift storage.
RedshiftPropertiesOutput
Description
The Amazon Redshift properties.
Members
- credentials
-
- Type: RedshiftCredentials structure
The Amazon Redshift credentials.
- databaseName
-
- Type: string
The Amazon Redshift database name.
- isProvisionedSecret
-
- Type: boolean
Specifies whether Amaon Redshift properties has a provisioned secret.
- jdbcIamUrl
-
- Type: string
The jdbcIam URL of the Amazon Redshift properties.
- jdbcUrl
-
- Type: string
The jdbcURL of the Amazon Redshift properties.
- lineageSync
-
- Type: RedshiftLineageSyncConfigurationOutput structure
The lineage syn of the Amazon Redshift properties.
- redshiftTempDir
-
- Type: string
The redshiftTempDir of the Amazon Redshift properties.
- status
-
- Type: string
The status in the Amazon Redshift properties.
- storage
-
- Type: RedshiftStorageProperties structure
The storage in the Amazon Redshift properties.
RedshiftPropertiesPatch
Description
Amazon Redshift properties patch.
Members
- credentials
-
- Type: RedshiftCredentials structure
The credentials in the Amazon Redshift properties patch.
- databaseName
-
- Type: string
The name in the Amazon Redshift properties patch.
- host
-
- Type: string
The host in the Amazon Redshift properties patch.
- lineageSync
-
- Type: RedshiftLineageSyncConfigurationInput structure
The lineage sync in the Amazon Redshift properties patch.
- port
-
- Type: int
The port in the Amazon Redshift properties patch.
- storage
-
- Type: RedshiftStorageProperties structure
The storage in the Amazon Redshift properties patch.
RedshiftRunConfigurationInput
Description
The configuration details of the Amazon Redshift data source.
Members
- dataAccessRole
-
- Type: string
The data access role included in the configuration details of the Amazon Redshift data source.
- redshiftCredentialConfiguration
-
- Type: RedshiftCredentialConfiguration structure
The details of the credentials required to access an Amazon Redshift cluster.
- redshiftStorage
-
- Type: RedshiftStorage structure
The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.
- relationalFilterConfigurations
-
- Required: Yes
- Type: Array of RelationalFilterConfiguration structures
The relational filger configurations included in the configuration details of the Amazon Redshift data source.
RedshiftRunConfigurationOutput
Description
The configuration details of the Amazon Redshift data source.
Members
- accountId
-
- Type: string
The ID of the Amazon Web Services account included in the configuration details of the Amazon Redshift data source.
- dataAccessRole
-
- Type: string
The data access role included in the configuration details of the Amazon Redshift data source.
- redshiftCredentialConfiguration
-
- Type: RedshiftCredentialConfiguration structure
The details of the credentials required to access an Amazon Redshift cluster.
- redshiftStorage
-
- Required: Yes
- Type: RedshiftStorage structure
The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.
- region
-
- Type: string
The Amazon Web Services region included in the configuration details of the Amazon Redshift data source.
- relationalFilterConfigurations
-
- Required: Yes
- Type: Array of RelationalFilterConfiguration structures
The relational filger configurations included in the configuration details of the Amazon Redshift data source.
RedshiftSelfGrantStatusOutput
Description
The details for the self granting status for an Amazon Redshift data source.
Members
- selfGrantStatusDetails
-
- Required: Yes
- Type: Array of SelfGrantStatusDetail structures
The details for the self granting status for an Amazon Redshift data source.
RedshiftServerlessStorage
Description
The details of the Amazon Redshift Serverless workgroup storage.
Members
- workgroupName
-
- Required: Yes
- Type: string
The name of the Amazon Redshift Serverless workgroup.
RedshiftStorage
Description
The details of the Amazon Redshift storage as part of the configuration of an Amazon Redshift data source run.
Members
- redshiftClusterSource
-
- Type: RedshiftClusterStorage structure
The details of the Amazon Redshift cluster source.
- redshiftServerlessSource
-
- Type: RedshiftServerlessStorage structure
The details of the Amazon Redshift Serverless workgroup source.
RedshiftStorageProperties
Description
The Amazon Redshift storage properties.
Members
- clusterName
-
- Type: string
The cluster name in the Amazon Redshift storage properties.
- workgroupName
-
- Type: string
The workgroup name in the Amazon Redshift storage properties.
Region
Description
The Amazon Web Services Region.
Members
- regionName
-
- Type: string
The Amazon Web Services Region name.
- regionNamePath
-
- Type: string
The region name path.
RejectChoice
Description
The details of the automatically generated business metadata that is rejected.
Members
- predictionChoices
-
- Type: Array of ints
Specifies the the automatically generated business metadata that can be rejected.
- predictionTarget
-
- Required: Yes
- Type: string
Specifies the target (for example, a column name) where a prediction can be rejected.
RejectRule
Description
Specifies the rule and the threshold under which a prediction can be rejected.
Members
- rule
-
- Type: string
Specifies whether you want to reject the top prediction for all targets or none.
- threshold
-
- Type: float
The confidence score that specifies the condition at which a prediction can be rejected.
RelationalFilterConfiguration
Description
The relational filter configuration for the data source.
Members
- databaseName
-
- Required: Yes
- Type: string
The database name specified in the relational filter configuration for the data source.
- filterExpressions
-
- Type: Array of FilterExpression structures
The filter expressions specified in the relational filter configuration for the data source.
- schemaName
-
- Type: string
The schema name specified in the relational filter configuration for the data source.
Resource
Description
The details of a provisioned resource of this Amazon DataZone environment.
Members
- name
-
- Type: string
The name of a provisioned resource of this Amazon DataZone environment.
- provider
-
- Type: string
The provider of a provisioned resource of this Amazon DataZone environment.
- type
-
- Required: Yes
- Type: string
The type of a provisioned resource of this Amazon DataZone environment.
- value
-
- Required: Yes
- Type: string
The value of a provisioned resource of this Amazon DataZone environment.
ResourceNotFoundException
Description
The specified resource cannot be found.
Members
- message
-
- Required: Yes
- Type: string
RowFilter
Description
The row filter.
Members
- and
-
- Type: Array of RowFilter structures
The 'and' clause of the row filter.
- expression
-
- Type: RowFilterExpression structure
The expression of the row filter.
- or
-
- Type: Array of RowFilter structures
The 'or' clause of the row filter.
RowFilterConfiguration
Description
The row filter configuration details.
Members
- rowFilter
-
- Required: Yes
- Type: RowFilter structure
The row filter.
- sensitive
-
- Type: boolean
Specifies whether the row filter is sensitive.
RowFilterExpression
Description
The row filter expression.
Members
- equalTo
-
- Type: EqualToExpression structure
The 'equal to' clause of the row filter expression.
- greaterThan
-
- Type: GreaterThanExpression structure
The 'greater than' clause of the row filter expression.
- greaterThanOrEqualTo
-
- Type: GreaterThanOrEqualToExpression structure
The 'greater than or equal to' clause of the filter expression.
- in
-
- Type: InExpression structure
The 'in' clause of the row filter expression.
- isNotNull
-
- Type: IsNotNullExpression structure
The 'is not null' clause of the row filter expression.
- isNull
-
- Type: IsNullExpression structure
The 'is null' clause of the row filter expression.
- lessThan
-
- Type: LessThanExpression structure
The 'less than' clause of the row filter expression.
- lessThanOrEqualTo
-
- Type: LessThanOrEqualToExpression structure
The 'less than or equal to' clause of the row filter expression.
- like
-
- Type: LikeExpression structure
The 'like' clause of the row filter expression.
- notEqualTo
-
- Type: NotEqualToExpression structure
The 'no equal to' clause of the row filter expression.
- notIn
-
- Type: NotInExpression structure
The 'not in' clause of the row filter expression.
- notLike
-
- Type: NotLikeExpression structure
The 'not like' clause of the row filter expression.
RuleDetail
Description
The details of a rule.
Members
- metadataFormEnforcementDetail
-
- Type: MetadataFormEnforcementDetail structure
The enforcement detail of the metadata form.
RuleScope
Description
The scope of a rule.
Members
- assetType
-
- Type: AssetTypesForRule structure
The asset type included in the rule scope.
- dataProduct
-
- Type: boolean
The data product included in the rule scope.
- project
-
- Type: ProjectsForRule structure
The project included in the rule scope.
RuleSummary
Description
The summary of the rule.
Members
- action
-
- Type: string
The action of the rule.
- identifier
-
- Type: string
The ID of the rule.
- lastUpdatedBy
-
- Type: string
The timestamp at which the rule was last updated.
- name
-
- Type: string
The name of the rule.
- revision
-
- Type: string
The revision of the rule.
- ruleType
-
- Type: string
The type of the rule.
- scope
-
- Type: RuleScope structure
The scope of the rule.
- target
-
- Type: RuleTarget structure
The target of the rule.
- targetType
-
- Type: string
The target type of the rule.
- updatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp at which the rule was last updated.
RuleTarget
Description
The target of the rule.
Members
- domainUnitTarget
-
- Type: DomainUnitTarget structure
The ID of the domain unit.
RunStatisticsForAssets
Description
The asset statistics from the data source run.
Members
- added
-
- Type: int
The
added
statistic for the data source run. - failed
-
- Type: int
The
failed
statistic for the data source run. - skipped
-
- Type: int
The
skipped
statistic for the data source run. - unchanged
-
- Type: int
The
unchanged
statistic for the data source run. - updated
-
- Type: int
The
updated
statistic for the data source run.
SageMakerRunConfigurationInput
Description
The Amazon SageMaker run configuration.
Members
- trackingAssets
-
- Required: Yes
- Type: Associative array of custom strings keys (SageMakerAssetType) to stringss
The tracking assets of the Amazon SageMaker run.
SageMakerRunConfigurationOutput
Description
The Amazon SageMaker run configuration.
Members
- accountId
-
- Type: string
The Amazon SageMaker account ID.
- region
-
- Type: string
The Amazon SageMaker Region.
- trackingAssets
-
- Required: Yes
- Type: Associative array of custom strings keys (SageMakerAssetType) to stringss
The tracking assets of the Amazon SageMaker.
ScheduleConfiguration
Description
The details of the schedule of the data source runs.
Members
- schedule
-
- Type: string
The schedule of the data source runs.
- timezone
-
- Type: string
The timezone of the data source run.
SearchInItem
Description
The details of the search.
Members
- attribute
-
- Required: Yes
- Type: string
The search attribute.
SearchInventoryResultItem
Description
The details of the search results.
Members
- assetItem
-
- Type: AssetItem structure
The asset item included in the search results.
- dataProductItem
-
- Type: DataProductResultItem structure
The data product.
- glossaryItem
-
- Type: GlossaryItem structure
The glossary item included in the search results.
- glossaryTermItem
-
- Type: GlossaryTermItem structure
The glossary term item included in the search results.
SearchResultItem
Description
The details of the results of the SearchListings
action.
Members
- assetListing
-
- Type: AssetListingItem structure
The asset listing included in the results of the
SearchListings
action. - dataProductListing
-
- Type: DataProductListingItem structure
The data product listing.
SearchSort
Description
The details of the way to sort search results.
Members
- attribute
-
- Required: Yes
- Type: string
The attribute detail of the way to sort search results.
- order
-
- Type: string
The order detail of the wya to sort search results.
SearchTypesResultItem
Description
The details of the results of the SearchTypes
action.
Members
- assetTypeItem
-
- Type: AssetTypeItem structure
The asset type included in the results of the
SearchTypes
action. - formTypeItem
-
- Type: FormTypeData structure
The form type included in the results of the
SearchTypes
action. - lineageNodeTypeItem
-
- Type: LineageNodeTypeItem structure
The details of a data lineage node type.
SelfGrantStatusDetail
Description
The details for the self granting status.
Members
- databaseName
-
- Required: Yes
- Type: string
The name of the database used for the data source.
- failureCause
-
- Type: string
The reason for why the operation failed.
- schemaName
-
- Type: string
The name of the schema used in the data source.
- status
-
- Required: Yes
- Type: string
The self granting status of the data source.
SelfGrantStatusOutput
Description
The details for the self granting status for a data source.
Members
- glueSelfGrantStatus
-
- Type: GlueSelfGrantStatusOutput structure
The details for the self granting status for a Glue data source.
- redshiftSelfGrantStatus
-
- Type: RedshiftSelfGrantStatusOutput structure
The details for the self granting status for an Amazon Redshift data source.
ServiceQuotaExceededException
Description
The request has exceeded the specified service quota.
Members
- message
-
- Required: Yes
- Type: string
SingleSignOn
Description
The single sign-on details in Amazon DataZone.
Members
- type
-
- Type: string
The type of single sign-on in Amazon DataZone.
- userAssignment
-
- Type: string
The single sign-on user assignment in Amazon DataZone.
SparkEmrPropertiesInput
Description
The Spark EMR properties.
Members
- computeArn
-
- Type: string
The compute ARN of Spark EMR.
- instanceProfileArn
-
- Type: string
The instance profile ARN of Spark EMR.
- javaVirtualEnv
-
- Type: string
The java virtual env of the Spark EMR.
- logUri
-
- Type: string
The log URI of the Spark EMR.
- pythonVirtualEnv
-
- Type: string
The Python virtual env of the Spark EMR.
- runtimeRole
-
- Type: string
The runtime role of the Spark EMR.
- trustedCertificatesS3Uri
-
- Type: string
The certificates S3 URI of the Spark EMR.
SparkEmrPropertiesOutput
Description
The Spark EMR properties.
Members
- computeArn
-
- Type: string
The compute ARN of the Spark EMR.
- credentials
-
- Type: UsernamePassword structure
The credentials of the Spark EMR.
- credentialsExpiration
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The credential expiration of the Spark EMR.
- governanceType
-
- Type: string
The governance type of the Spark EMR.
- instanceProfileArn
-
- Type: string
The instance profile ARN of the Spark EMR.
- javaVirtualEnv
-
- Type: string
The Java virtual env of the Spark EMR.
- livyEndpoint
-
- Type: string
The livy endpoint of the Spark EMR.
- logUri
-
- Type: string
The log URI of the Spark EMR.
- pythonVirtualEnv
-
- Type: string
The Python virtual env of the Spark EMR.
- runtimeRole
-
- Type: string
The runtime role of the Spark EMR.
- trustedCertificatesS3Uri
-
- Type: string
The trusted certificate S3 URL of the Spark EMR.
SparkEmrPropertiesPatch
Description
The Spark EMR properties patch.
Members
- computeArn
-
- Type: string
The compute ARN in the Spark EMR properties patch.
- instanceProfileArn
-
- Type: string
The instance profile ARN in the Spark EMR properties patch.
- javaVirtualEnv
-
- Type: string
The Java virtual evn in the Spark EMR properties patch.
- logUri
-
- Type: string
The log URI in the Spark EMR properties patch.
- pythonVirtualEnv
-
- Type: string
The Python virtual env in the Spark EMR properties patch.
- runtimeRole
-
- Type: string
The runtime role in the Spark EMR properties patch.
- trustedCertificatesS3Uri
-
- Type: string
The trusted certificates S3 URI in the Spark EMR properties patch.
SparkGlueArgs
Description
The Spark Amazon Web Services Glue args.
Members
- connection
-
- Type: string
The connection in the Spark Amazon Web Services Glue args.
SparkGluePropertiesInput
Description
The Spark Amazon Web Services Glue properties.
Members
- additionalArgs
-
- Type: SparkGlueArgs structure
The additional args in the Spark Amazon Web Services Glue properties.
- glueConnectionName
-
- Type: string
The Amazon Web Services Glue connection name in the Spark Amazon Web Services Glue properties.
- glueVersion
-
- Type: string
The Amazon Web Services Glue version in the Spark Amazon Web Services Glue properties.
- idleTimeout
-
- Type: int
The idle timeout in the Spark Amazon Web Services Glue properties.
- javaVirtualEnv
-
- Type: string
The Java virtual env in the Spark Amazon Web Services Glue properties.
- numberOfWorkers
-
- Type: int
The number of workers in the Spark Amazon Web Services Glue properties.
- pythonVirtualEnv
-
- Type: string
The Python virtual env in the Spark Amazon Web Services Glue properties.
- workerType
-
- Type: string
The worker type in the Spark Amazon Web Services Glue properties.
SparkGluePropertiesOutput
Description
The Spark Amazon Web Services Glue properties.
Members
- additionalArgs
-
- Type: SparkGlueArgs structure
The additional args in the Spark Amazon Web Services Glue properties.
- glueConnectionName
-
- Type: string
The Amazon Web Services Glue connection name in the Spark Amazon Web Services Glue properties.
- glueVersion
-
- Type: string
The Amazon Web Services Glue version in the Spark Amazon Web Services Glue properties.
- idleTimeout
-
- Type: int
The idle timeout in the Spark Amazon Web Services Glue properties.
- javaVirtualEnv
-
- Type: string
The Java virtual env in the Spark Amazon Web Services Glue properties.
- numberOfWorkers
-
- Type: int
The number of workers in the Spark Amazon Web Services Glue properties.
- pythonVirtualEnv
-
- Type: string
The Python virtual env in the Spark Amazon Web Services Glue properties.
- workerType
-
- Type: string
The worker type in the Spark Amazon Web Services Glue properties.
SsoUserProfileDetails
Description
The single sign-on details of the user profile.
Members
- firstName
-
- Type: string
The first name included in the single sign-on details of the user profile.
- lastName
-
- Type: string
The last name included in the single sign-on details of the user profile.
- username
-
- Type: string
The username included in the single sign-on details of the user profile.
SubscribedAsset
Description
The details of the asset for which the subscription grant is created.
Members
- assetId
-
- Required: Yes
- Type: string
The identifier of the asset for which the subscription grant is created.
- assetRevision
-
- Required: Yes
- Type: string
The revision of the asset for which the subscription grant is created.
- assetScope
-
- Type: AssetScope structure
The asset scope of the subscribed asset.
- failureCause
-
- Type: FailureCause structure
The failure cause included in the details of the asset for which the subscription grant is created.
- failureTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The failure timestamp included in the details of the asset for which the subscription grant is created.
- grantedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when the subscription grant to the asset is created.
- status
-
- Required: Yes
- Type: string
The status of the asset for which the subscription grant is created.
- targetName
-
- Type: string
The target name of the asset for which the subscription grant is created.
SubscribedAssetListing
Description
The details of the published asset for which the subscription grant is created.
Members
- assetScope
-
- Type: AssetScope structure
The asset scope of the subscribed asset listing.
- entityId
-
- Type: string
The identifier of the published asset for which the subscription grant is created.
- entityRevision
-
- Type: string
The revision of the published asset for which the subscription grant is created.
- entityType
-
- Type: string
The type of the published asset for which the subscription grant is created.
- forms
-
- Type: string
The forms attached to the published asset for which the subscription grant is created.
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms attached to the published asset for which the subscription grant is created.
SubscribedListing
Description
The details of the published asset for which the subscription grant is created.
Members
- description
-
- Required: Yes
- Type: string
The description of the published asset for which the subscription grant is created.
- id
-
- Required: Yes
- Type: string
The identifier of the published asset for which the subscription grant is created.
- item
-
- Required: Yes
- Type: SubscribedListingItem structure
The published asset for which the subscription grant is created.
- name
-
- Required: Yes
- Type: string
The name of the published asset for which the subscription grant is created.
- ownerProjectId
-
- Required: Yes
- Type: string
The identifier of the project of the published asset for which the subscription grant is created.
- ownerProjectName
-
- Type: string
The name of the project that owns the published asset for which the subscription grant is created.
- revision
-
- Type: string
The revision of the published asset for which the subscription grant is created.
SubscribedListingInput
Description
The published asset for which the subscription grant is to be created.
Members
- identifier
-
- Required: Yes
- Type: string
The identifier of the published asset for which the subscription grant is to be created.
SubscribedListingItem
Description
The published asset for which the subscription grant is created.
Members
- assetListing
-
- Type: SubscribedAssetListing structure
The asset for which the subscription grant is created.
- productListing
-
- Type: SubscribedProductListing structure
The data product listing.
SubscribedPrincipal
Description
The principal that has the subscription grant for the asset.
Members
- project
-
- Type: SubscribedProject structure
The project that has the subscription grant.
SubscribedPrincipalInput
Description
The principal that is to be given a subscriptiong grant.
Members
- project
-
- Type: SubscribedProjectInput structure
The project that is to be given a subscription grant.
SubscribedProductListing
Description
The data product listing.
Members
- assetListings
-
- Type: Array of AssetInDataProductListingItem structures
The data assets of the data product listing.
- description
-
- Type: string
The description of the data product listing.
- entityId
-
- Type: string
The ID of the data product listing.
- entityRevision
-
- Type: string
The revision of the data product listing.
- glossaryTerms
-
- Type: Array of DetailedGlossaryTerm structures
The glossary terms of the data product listing.
- name
-
- Type: string
The name of the data product listing.
SubscribedProject
Description
The project that has the subscription grant.
Members
- id
-
- Type: string
The identifier of the project that has the subscription grant.
- name
-
- Type: string
The name of the project that has the subscription grant.
SubscribedProjectInput
Description
The project that is to be given a subscription grant.
Members
- identifier
-
- Type: string
The identifier of the project that is to be given a subscription grant.
SubscriptionGrantSummary
Description
The details of the subscription grant.
Members
- assets
-
- Type: Array of SubscribedAsset structures
The assets included in the subscription grant.
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a subscription grant was created.
- createdBy
-
- Required: Yes
- Type: string
The datazone user who created the subscription grant.
- domainId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone domain in which a subscription grant exists.
- grantedEntity
-
- Required: Yes
- Type: GrantedEntity structure
The entity to which the subscription is granted.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription grant.
- status
-
- Required: Yes
- Type: string
The status of the subscription grant.
- subscriptionId
-
- Type: string
The ID of the subscription.
- subscriptionTargetId
-
- Required: Yes
- Type: string
The identifier of the target of the subscription grant.
- updatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestampf of when the subscription grant was updated.
- updatedBy
-
- Type: string
The Amazon DataZone user who updated the subscription grant.
SubscriptionRequestSummary
Description
The details of the subscription request.
Members
- createdAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of when a 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 identifier of the Amazon DataZone domain in which a subscription request exists.
- existingSubscriptionId
-
- Type: string
The ID of the existing subscription.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription request.
- metadataFormsSummary
-
- Type: Array of MetadataFormSummary structures
The summary of the metadata forms.
- requestReason
-
- Required: Yes
- Type: string
The reason for the subscription request.
- reviewerId
-
- Type: string
The identifier of the subscription request reviewer.
- status
-
- Required: Yes
- Type: string
The status of the subscription request.
- subscribedListings
-
- Required: Yes
- Type: Array of SubscribedListing structures
The listings included in the subscription request.
- subscribedPrincipals
-
- Required: Yes
- Type: Array of SubscribedPrincipal structures
The principals included 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 identifier of the Amazon DataZone user who updated the subscription request.
SubscriptionSummary
Description
The details of the subscription.
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 identifier of the Amazon DataZone domain in which a subscription exists.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription.
- retainPermissions
-
- Type: boolean
The retain permissions included in the subscription.
- status
-
- Required: Yes
- Type: string
The status of the subscription.
- subscribedListing
-
- Required: Yes
- Type: SubscribedListing structure
The listing included in the subscription.
- subscribedPrincipal
-
- Required: Yes
- Type: SubscribedPrincipal structure
The principal included in the subscription.
- subscriptionRequestId
-
- Type: string
The identifier of the subscription request for the subscription.
- 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.
SubscriptionTargetForm
Description
The details of the subscription target configuration.
Members
- content
-
- Required: Yes
- Type: string
The content of the subscription target configuration.
- formName
-
- Required: Yes
- Type: string
The form name included in the subscription target configuration.
SubscriptionTargetSummary
Description
The details of the subscription target.
Members
- applicableAssetTypes
-
- Required: Yes
- Type: Array of strings
The asset types included in the subscription target.
- authorizedPrincipals
-
- Required: Yes
- Type: Array of strings
The authorized principals included in 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 identifier of the Amazon DataZone domain in which the subscription target exists.
- environmentId
-
- Required: Yes
- Type: string
The identifier of the environment of the subscription target.
- id
-
- Required: Yes
- Type: string
The identifier of the subscription target.
- manageAccessRole
-
- Type: string
The manage access role specified in the subscription target.
- name
-
- Required: Yes
- Type: string
The name of the subscription target.
- projectId
-
- Required: Yes
- Type: string
The identifier of the project specified in 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 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.
TermRelations
Description
The details of the term relations.
Members
- classifies
-
- Type: Array of strings
The classifies of the term relations.
- isA
-
- Type: Array of strings
The
isA
property of the term relations.
ThrottlingException
Description
The request was denied due to request throttling.
Members
- message
-
- Required: Yes
- Type: string
TimeSeriesDataPointFormInput
Description
The time series data points form.
Members
- content
-
- Type: string
The content of the time series data points form.
- formName
-
- Required: Yes
- Type: string
The name of the time series data points form.
- timestamp
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of the time series data points form.
- typeIdentifier
-
- Required: Yes
- Type: string
The ID of the type of the time series data points form.
- typeRevision
-
- Type: string
The revision type of the time series data points form.
TimeSeriesDataPointFormOutput
Description
The time series data points form.
Members
- content
-
- Type: string
The content of the time series data points form.
- formName
-
- Required: Yes
- Type: string
The name of the time series data points form.
- id
-
- Type: string
The ID of the time series data points form.
- timestamp
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of the time series data points form.
- typeIdentifier
-
- Required: Yes
- Type: string
The ID of the type of the time series data points form.
- typeRevision
-
- Type: string
The revision type of the time series data points form.
TimeSeriesDataPointSummaryFormOutput
Description
The summary of the time series data points form.
Members
- contentSummary
-
- Type: string
The content of the summary of the time series data points form.
- formName
-
- Required: Yes
- Type: string
The name of the time series data points summary form.
- id
-
- Type: string
The ID of the time series data points summary form.
- timestamp
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of the time series data points summary form.
- typeIdentifier
-
- Required: Yes
- Type: string
The type ID of the time series data points summary form.
- typeRevision
-
- Type: string
The type revision of the time series data points summary form.
Topic
Description
The topic of the notification.
Members
- resource
-
- Required: Yes
- Type: NotificationResource structure
The details of the resource mentioned in a notification.
- role
-
- Required: Yes
- Type: string
The role of the resource mentioned in a notification.
- subject
-
- Required: Yes
- Type: string
The subject of the resource mentioned in a notification.
UnauthorizedException
Description
You do not have permission to perform this action.
Members
- message
-
- Required: Yes
- Type: string
Unit
Description
The details of the policy of creating an environment.
Members
UserDetails
Description
The user details of a project member.
Members
- userId
-
- Required: Yes
- Type: string
The identifier of the Amazon DataZone user.
UserPolicyGrantPrincipal
Description
The user policy grant principal.
Members
- allUsersGrantFilter
-
- Type: AllUsersGrantFilter structure
The all users grant filter of the user policy grant principal.
- userIdentifier
-
- Type: string
The user ID of the user policy grant principal.
UserProfileDetails
Description
The details of the user profile in Amazon DataZone.
Members
- iam
-
- Type: IamUserProfileDetails structure
The IAM details included in the user profile details.
- sso
-
- Type: SsoUserProfileDetails structure
The single sign-on details included in the user profile details.
UserProfileSummary
Description
The details of the user profile.
Members
- details
-
- Type: UserProfileDetails structure
The details of the user profile.
- domainId
-
- Type: string
The ID of the Amazon DataZone domain of the user profile.
- id
-
- Type: string
The ID of the user profile.
- status
-
- Type: string
The status of the user profile.
- type
-
- Type: string
The type of the user profile.
UsernamePassword
Description
The username and password of a connection.
Members
- password
-
- Required: Yes
- Type: string
The password of a connection.
- username
-
- Required: Yes
- Type: string
The username of a connection.
ValidationException
Description
The input fails to satisfy the constraints specified by the Amazon Web Services service.
Members
- message
-
- Required: Yes
- Type: string