Skip to content

Add CPS note to Painless execute API index parameter#144895

Open
marciw wants to merge 3 commits intoelastic:mainfrom
marciw:mw-cps-painless-ref
Open

Add CPS note to Painless execute API index parameter#144895
marciw wants to merge 3 commits intoelastic:mainfrom
marciw:mw-cps-painless-ref

Conversation

@marciw
Copy link
Contributor

@marciw marciw commented Mar 24, 2026

Companion to the docs-content PR documenting Painless execute behavior with cross-project search

Screenshot of updated doc (previews are temporarily unavailable):

Details

current page: https://www.elastic.co/docs/reference/scripting-languages/painless/painless-api-examples#properties-of-script

addition:
Screenshot 2026-03-24 at 5 47 25 PM

@marciw marciw marked this pull request as ready for review March 24, 2026 23:01
@marciw marciw requested a review from a team as a code owner March 24, 2026 23:01
@elasticsearchmachine elasticsearchmachine added the needs:triage Requires assignment of a team area label label Mar 24, 2026
@marciw marciw added Team:Docs Meta label for docs team and removed needs:triage Requires assignment of a team area label labels Mar 24, 2026
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/core-docs (Team:Docs)

@marciw marciw added >docs General docs changes :Docs/Dev Docs team for PDC:Search concepts (search, analytics, timeseries, ML, dev tools) labels Mar 24, 2026
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/developer-docs (:Docs/Dev)

@marciw marciw added :Docs/Admin Docs team for ES Datastore and Platform Billing (deploy, clusters, distro, sec, perf, metering) and removed :Docs/Dev Docs team for PDC:Search concepts (search, analytics, timeseries, ML, dev tools) labels Mar 24, 2026
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/admin-docs (:Docs/Admin)

Copy link
Member

@yetanothertw yetanothertw left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

Copy link
Contributor

@pawankartik-elastic pawankartik-elastic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Contributor

@quux00 quux00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - thank you!

Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one suggest


`index`
: (Required, string) Index containing a mapping that’s compatible with the indexed document. You may specify a remote index by prefixing the index with the remote cluster alias. For example, `remote1:my_index` indicates that you want to execute the painless script against the "my_index" index on the "remote1" cluster. This request will be forwarded to the "remote1" cluster if you have [configured a connection](docs-content://deploy-manage/remote-clusters/remote-clusters-self-managed.md) to that remote cluster.
: (Required, string) Index containing a mapping that’s compatible with the indexed document. You can specify a remote index by prefixing the index with the remote cluster alias. For example, `remote1:my_index` indicates that you want to execute the painless script against the "my_index" index on the "remote1" cluster. This request will be forwarded to the "remote1" cluster if you have [configured a connection](docs-content://deploy-manage/remote-clusters/remote-clusters-self-managed.md) to that remote cluster.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you qualify this so the whole thing applies to cps and ccs, or split this so this paragraph is more clearly about CCS?

dedicated paragraphs

Suggested change
: (Required, string) Index containing a mapping that’s compatible with the indexed document. You can specify a remote index by prefixing the index with the remote cluster alias. For example, `remote1:my_index` indicates that you want to execute the painless script against the "my_index" index on the "remote1" cluster. This request will be forwarded to the "remote1" cluster if you have [configured a connection](docs-content://deploy-manage/remote-clusters/remote-clusters-self-managed.md) to that remote cluster.
: (Required, string) Index containing a mapping that’s compatible with the indexed document.
{applies_to}`stack: ga` When using {{ccs}}, you can specify a remote index by prefixing the index with the remote cluster alias. For example, `remote1:my_index` indicates that you want to execute the painless script against the "my_index" index on the "remote1" cluster or project. This request will be forwarded to the "remote1" cluster if you have [configured a connection](docs-content://deploy-manage/remote-clusters/remote-clusters-self-managed.md) to that remote cluster.

mixy guy

Suggested change
: (Required, string) Index containing a mapping that’s compatible with the indexed document. You can specify a remote index by prefixing the index with the remote cluster alias. For example, `remote1:my_index` indicates that you want to execute the painless script against the "my_index" index on the "remote1" cluster. This request will be forwarded to the "remote1" cluster if you have [configured a connection](docs-content://deploy-manage/remote-clusters/remote-clusters-self-managed.md) to that remote cluster.
: (Required, string) Index containing a mapping that’s compatible with the indexed document. When using {{ccs}} or {{cps}}, you can specify a remote index by prefixing the index with the remote cluster alias. For example, `remote1:my_index` indicates that you want to execute the painless script against the "my_index" index on the "remote1" cluster or project. This request will be forwarded to the "remote1" cluster or project if you have configured a connection to that remote cluster, or linked the project.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

:Docs/Admin Docs team for ES Datastore and Platform Billing (deploy, clusters, distro, sec, perf, metering) >docs General docs changes Team:Docs Meta label for docs team v9.4.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants