Partial update an index attribute
patch
/gsadmin/v1/{appName}/attributes/{owner}/{attributeName}
Partial updates the specific index attribute in the given config owner attributes list.
Request
Supported Media Types
- application/json
Path Parameters
-
appName: string
Specifies the name of your application. For example, "cloud".
-
attributeName: string
Specifies the attribute name in the owner's index attributes, for example, "product.name"
-
owner: string
Specifies the owner of the index attributes, for example, system.
The request body represents the partially updated index attribute.
Root Schema : Attribute
Type:
object
Represents an index attribute. The object conforms to one of the following ecr-types:
Show Source
- dimension
- property
- derived-property
-
context(optional):
array context
Attributes can be contextual by one of two types: locale or priceGroup, but not both. Custom contexts won't work.
-
derivedPropertyFunction(optional):
string
-
derivedPropertySource(optional):
string
-
displayConfig(optional):
object DisplayConfig
Contains configuration on how to display a facet and its facet values.
-
displayOrder(optional):
integer
-
ecr:createDate(optional):
string
-
ecr:lastModified(optional):
string
-
ecr:lastModifiedBy(optional):
string
-
ecr:type(optional):
string
Allowed Values:
[ "dimension", "property", "derived-property" ]
-
indexingTransforms(optional):
array indexingTransforms
-
isAutogen(optional):
boolean
-
isRecordSearchEnabled(optional):
boolean
-
isWildcardEnabledInRecordSearch(optional):
boolean
-
propertyDataType(optional):
string
-
rangeComparisonType(optional):
string
Allowed Values:
[ "FLOAT", "STRING", "INTEGER" ]
Defines the data type used when creating custom range facets. For instance, to create a rating facet with values like '4.5 to 5.0', you would use FLOAT. To create an Author Last Name facet with values like 'A-L', STRING would be the type. To define the actual ranges, you would upload to /gsdata/v1/cloud/facets/{attribute name}. -
seoConfig(optional):
object SeoConfig
Contains configuration on which dimensions are included in SEO links. Respected only if using SeoUrlFormatterFactory.
-
sourcePropertyNames(optional):
array sourcePropertyNames
Nested Schema : context
Type:
array
Attributes can be contextual by one of two types: locale or priceGroup, but not both. Custom contexts won't work.
Show Source
Nested Schema : DisplayConfig
Type:
object
Contains configuration on how to display a facet and its facet values.
Show Source
-
sort(optional):
string
This defines a list of sort options for sorting the values of this facet. Each sort option is specified by a sort function, comma, sort order. Multiple sort options are separated by semicolons and any number of sort options may be specified. Possible sort functions are 'displayName', 'sig', 'count', and 'displayOrder' and sort orders are 'asc' and 'desc'. For example, to sort by displayOrder ascending and break ties by counts descending use 'displayOrder,asc;count,desc'. 'displayName' will sort the values alphabetically. 'count' will sort the values based on the count of records tagged to (otherwise known as facet value counts). 'displayOrder' will order the values based on the corresponding 'displayOrder' values as configured using /gsdata/v1/{appName}/facets. 'sig' sorts the list of facet values by relevance to the current query by computing the statistical significance of this facet value over the result list. If no sort is configured, the facet values will be sorted by count descending. Deprecated older values (but still accepted) are 'alpha', 'freq' and 'rank', which correspond to 'displayName', 'count' and 'displayOrder' respectively.
-
translations(optional):
object translations
This allows you to specify per-locale translations of the display name for this facet. If no 'displayName' values are configured, or are omitted for a given locale, then the facet name is returned. Locale codes are those used by search and comply with BCP-47 Locale codes in Java. You can cross-reference the locales currently configured for search by GET /gsadmin/v1/cloud/searchIndexConfig.
Example:
{
"sort":"displayName,asc;count,desc",
"translations":{
"en":{
"displayName":"Brand"
},
"fr":{
"displayName":"Marque"
}
}
}
Nested Schema : indexingTransforms
Type:
Show Source
array
-
Array of:
object IndexingTransform
Specifies a transformation to apply upon one or more source properties (inputs). The attribute which defines the transform is the destination property.
Nested Schema : SeoConfig
Type:
object
Contains configuration on which dimensions are included in SEO links. Respected only if using SeoUrlFormatterFactory.
Show Source
- includeInNavLinks(optional): boolean
-
includeInRecLinks(optional):
boolean
This defines if the dimval names under this dimension should be included in the SEO record links.
Nested Schema : translations
Type:
object
This allows you to specify per-locale translations of the display name for this facet. If no 'displayName' values are configured, or are omitted for a given locale, then the facet name is returned. Locale codes are those used by search and comply with BCP-47 Locale codes in Java. You can cross-reference the locales currently configured for search by GET /gsadmin/v1/cloud/searchIndexConfig.
Show Source
-
localeCode(optional):
object localeCode
A locale code where you wish to provide translations
Nested Schema : localeCode
Type:
object
A locale code where you wish to provide translations
Show Source
-
displayName(optional):
string
This is the localized display name for the given locale.
Nested Schema : IndexingTransform
Type:
object
Specifies a transformation to apply upon one or more source properties (inputs). The attribute which defines the transform is the destination property.
Show Source
-
ignoreDuplicatePropertyValues(optional):
boolean
The outputs of an indexing transform are made unique by suppressing any values that repeat existing assignments.
-
removeSourcePropertyValues(optional):
boolean
Discard the input properties that were used to generate the transform's output.
-
sourcePropertyNames(optional):
array sourcePropertyNames
An ordered list of inputs that the transform will consume. In the case of 'concatenate' transform, the first sourceProperty's value will appear first in the output value. If omitted, or identical to the output property name, then the transform happens in-place (an Identity Transform). The type 'split-jsonpath' is only supported as an Identity Transform.
-
splitPaths(optional):
string
List of JSON paths into the source properties from which to extract values. Only applies to 'split-jsonpath' transform
-
splitPattern(optional):
string
Regular expression that describes all delimiters between values. Only applies to 'split-regex' transform.
-
transform(optional):
string
Allowed Values:
[ "concatenate", "split-regex", "split-jsonpath" ]
The specific type of transformation:- concatenate: combines the values from the source properties into a single value, in the order that the source properties are specified. If any source properties have contextual (localized) values, then a separate output value shall be produced, restricting its inputs on a per-locale basis.
- split-regex: Separates the source properties' values into pieces based on the regex that encodes the separator value. Each piece becomes a distinct output value.
- split-jsonpath: Uses the supplied json paths to extract scalar values from source properties whose values contain json. Each scalar becomes an assignment in the output property. NOTE: 'split-jsonpath' is only supported as an Identity Transform.
-
trimWhitespace(optional):
boolean
Once source properties have been split into pieces via regular expression, remove whitespace from the ends of the pieces. Only applies to split-regex transform.
Example:
{
"transform":"split-jsonpath",
"splitPaths":[
"$['product.childSKUs'][*]['sku.id]",
"$['product.childSKUs'][*]['shoe.size']",
"$['product.childSKUs'][*]['shirt.size']"
]
}
Nested Schema : sourcePropertyNames
Type:
array
An ordered list of inputs that the transform will consume. In the case of 'concatenate' transform, the first sourceProperty's value will appear first in the output value. If omitted, or identical to the output property name, then the transform happens in-place (an Identity Transform). The type 'split-jsonpath' is only supported as an Identity Transform.
Show Source
Security
-
basicAuth: basic
Type:
basic
Description:Basic username/password authentication.
Response
Supported Media Types
- application/json
202 Response
Index attribute successfully updated.
Examples
Request Body Example
The following shows a sample request body to partially update an attribute in the specified owner index attributes list.
{ "isRecordSearchEnabled": false, "ecr:type": "dimension" }