- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
UpdateAssetFilterCommand
Updates an asset filter.
Example Syntax
Use a bare-bones client and the command you need to make an API call.
import { DataZoneClient, UpdateAssetFilterCommand } from "@aws-sdk/client-datazone"; // ES Modules import
// const { DataZoneClient, UpdateAssetFilterCommand } = require("@aws-sdk/client-datazone"); // CommonJS import
const client = new DataZoneClient(config);
const input = { // UpdateAssetFilterInput
domainIdentifier: "STRING_VALUE", // required
assetIdentifier: "STRING_VALUE", // required
identifier: "STRING_VALUE", // required
name: "STRING_VALUE",
description: "STRING_VALUE",
configuration: { // AssetFilterConfiguration Union: only one key present
columnConfiguration: { // ColumnFilterConfiguration
includedColumnNames: [ // ColumnNameList
"STRING_VALUE",
],
},
rowConfiguration: { // RowFilterConfiguration
rowFilter: { // RowFilter Union: only one key present
expression: { // RowFilterExpression Union: only one key present
equalTo: { // EqualToExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
notEqualTo: { // NotEqualToExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
greaterThan: { // GreaterThanExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
lessThan: { // LessThanExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
greaterThanOrEqualTo: { // GreaterThanOrEqualToExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
lessThanOrEqualTo: { // LessThanOrEqualToExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
isNull: { // IsNullExpression
columnName: "STRING_VALUE", // required
},
isNotNull: { // IsNotNullExpression
columnName: "STRING_VALUE", // required
},
in: { // InExpression
columnName: "STRING_VALUE", // required
values: [ // StringList // required
"STRING_VALUE",
],
},
notIn: { // NotInExpression
columnName: "STRING_VALUE", // required
values: [ // required
"STRING_VALUE",
],
},
like: { // LikeExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
notLike: { // NotLikeExpression
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
},
and: [ // RowFilterList
{// Union: only one key present
expression: {// Union: only one key present
equalTo: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
notEqualTo: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
greaterThan: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
lessThan: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
greaterThanOrEqualTo: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
lessThanOrEqualTo: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
isNull: {
columnName: "STRING_VALUE", // required
},
isNotNull: {
columnName: "STRING_VALUE", // required
},
in: {
columnName: "STRING_VALUE", // required
values: [ // required
"STRING_VALUE",
],
},
notIn: {
columnName: "STRING_VALUE", // required
values: [ // required
"STRING_VALUE",
],
},
like: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
notLike: {
columnName: "STRING_VALUE", // required
value: "STRING_VALUE", // required
},
},
and: [
"<RowFilter>",
],
or: [
"<RowFilter>",
],
},
],
or: [
"<RowFilter>",
],
},
sensitive: true || false,
},
},
};
const command = new UpdateAssetFilterCommand(input);
const response = await client.send(command);
// { // UpdateAssetFilterOutput
// id: "STRING_VALUE", // required
// domainId: "STRING_VALUE", // required
// assetId: "STRING_VALUE", // required
// name: "STRING_VALUE", // required
// description: "STRING_VALUE",
// status: "VALID" || "INVALID",
// configuration: { // AssetFilterConfiguration Union: only one key present
// columnConfiguration: { // ColumnFilterConfiguration
// includedColumnNames: [ // ColumnNameList
// "STRING_VALUE",
// ],
// },
// rowConfiguration: { // RowFilterConfiguration
// rowFilter: { // RowFilter Union: only one key present
// expression: { // RowFilterExpression Union: only one key present
// equalTo: { // EqualToExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// notEqualTo: { // NotEqualToExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// greaterThan: { // GreaterThanExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// lessThan: { // LessThanExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// greaterThanOrEqualTo: { // GreaterThanOrEqualToExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// lessThanOrEqualTo: { // LessThanOrEqualToExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// isNull: { // IsNullExpression
// columnName: "STRING_VALUE", // required
// },
// isNotNull: { // IsNotNullExpression
// columnName: "STRING_VALUE", // required
// },
// in: { // InExpression
// columnName: "STRING_VALUE", // required
// values: [ // StringList // required
// "STRING_VALUE",
// ],
// },
// notIn: { // NotInExpression
// columnName: "STRING_VALUE", // required
// values: [ // required
// "STRING_VALUE",
// ],
// },
// like: { // LikeExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// notLike: { // NotLikeExpression
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// },
// and: [ // RowFilterList
// {// Union: only one key present
// expression: {// Union: only one key present
// equalTo: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// notEqualTo: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// greaterThan: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// lessThan: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// greaterThanOrEqualTo: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// lessThanOrEqualTo: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// isNull: {
// columnName: "STRING_VALUE", // required
// },
// isNotNull: {
// columnName: "STRING_VALUE", // required
// },
// in: {
// columnName: "STRING_VALUE", // required
// values: [ // required
// "STRING_VALUE",
// ],
// },
// notIn: {
// columnName: "STRING_VALUE", // required
// values: [ // required
// "STRING_VALUE",
// ],
// },
// like: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// notLike: {
// columnName: "STRING_VALUE", // required
// value: "STRING_VALUE", // required
// },
// },
// and: [
// "<RowFilter>",
// ],
// or: [
// "<RowFilter>",
// ],
// },
// ],
// or: [
// "<RowFilter>",
// ],
// },
// sensitive: true || false,
// },
// },
// createdAt: new Date("TIMESTAMP"),
// errorMessage: "STRING_VALUE",
// effectiveColumnNames: [
// "STRING_VALUE",
// ],
// effectiveRowFilter: "STRING_VALUE",
// };
UpdateAssetFilterCommand Input
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
assetIdentifier Required | string | undefined | The ID of the data asset. |
domainIdentifier Required | string | undefined | The ID of the domain where you want to update an asset filter. |
identifier Required | string | undefined | The ID of the asset filter. |
configuration | AssetFilterConfiguration | undefined | The configuration of the asset filter. |
description | string | undefined | The description of the asset filter. |
name | string | undefined | The name of the asset filter. |
UpdateAssetFilterCommand Output
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
$metadata Required | ResponseMetadata | Metadata pertaining to this request. |
assetId Required | string | undefined | The ID of the data asset. |
configuration Required | AssetFilterConfiguration | undefined | The configuration of the asset filter. |
domainId Required | string | undefined | The ID of the domain where the asset filter was created. |
id Required | string | undefined | The ID of the asset filter. |
name Required | string | undefined | The name of the asset filter. |
createdAt | Date | undefined | The timestamp at which the asset filter was created. |
description | string | undefined | The description of the asset filter. |
effectiveColumnNames | string[] | undefined | The column names of the asset filter. |
effectiveRowFilter | string | undefined | The row filter of the asset filter. |
errorMessage | string | undefined | The error message that is displayed if the action is not completed successfully. |
status | FilterStatus | undefined | The status of the asset filter. |
Throws
Name | Fault | Details |
---|
Name | Fault | Details |
---|---|---|
AccessDeniedException | client | You do not have sufficient access to perform this action. |
ConflictException | client | There is a conflict while performing this action. |
InternalServerException | server | The request has failed because of an unknown error, exception or failure. |
ResourceNotFoundException | client | The specified resource cannot be found. |
ThrottlingException | client | The request was denied due to request throttling. |
ValidationException | client | The input fails to satisfy the constraints specified by the Amazon Web Services service. |
UnauthorizedException | client | You do not have permission to perform this action. |
DataZoneServiceException | Base exception class for all service exceptions from DataZone service. |