diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json index a87491a120..13ef07ea8f 100644 --- a/output/schema/schema-serverless.json +++ b/output/schema/schema-serverless.json @@ -170,7 +170,7 @@ "stability": "stable" } }, - "description": "Performs multiple indexing or delete operations in a single API call.\nThis reduces overhead and can greatly increase indexing speed.", + "description": "Bulk index or delete documents.\nPerforms multiple indexing or delete operations in a single API call.\nThis reduces overhead and can greatly increase indexing speed.", "docId": "docs-bulk", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/docs-bulk.html", "name": "bulk", @@ -771,7 +771,7 @@ "stability": "stable" } }, - "description": "Deletes component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", + "description": "Delete component templates.\nDeletes component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", "docId": "indices-component-template", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", "name": "cluster.delete_component_template", @@ -812,7 +812,7 @@ "stability": "stable" } }, - "description": "Returns information about whether a particular component template exist", + "description": "Check component templates.\nReturns information about whether a particular component template exists.", "docId": "indices-component-template", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", "name": "cluster.exists_component_template", @@ -848,7 +848,7 @@ "stability": "stable" } }, - "description": "Retrieves information about component templates.", + "description": "Get component templates.\nRetrieves information about component templates.", "docId": "indices-component-template", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", "name": "cluster.get_component_template", @@ -931,7 +931,7 @@ "stability": "stable" } }, - "description": "Creates or updates a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.", + "description": "Create or update a component template.\nCreates or updates a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.", "docId": "indices-component-template", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", "name": "cluster.put_component_template", @@ -2049,7 +2049,7 @@ "stability": "stable" } }, - "description": "Deletes a stored script or search template.", + "description": "Delete a script or search template.\nDeletes a stored script or search template.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html", "name": "delete_script", "request": { @@ -2644,7 +2644,7 @@ "stability": "stable" } }, - "description": "Retrieves a stored script or search template.", + "description": "Get a script or search template.\nRetrieves a stored script or search template.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html", "name": "get_script", "request": { @@ -7414,7 +7414,7 @@ "stability": "stable" } }, - "description": "Creates or updates a stored script or search template.", + "description": "Create or update a script or search template.\nCreates or updates a stored script or search template.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html", "name": "put_script", "request": { @@ -7845,7 +7845,7 @@ "stability": "experimental" } }, - "description": "Runs a script and returns a result.", + "description": "Run a script.\nRuns a script and returns a result.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-execute-api.html", "name": "scripts_painless_execute", "request": { @@ -8361,7 +8361,7 @@ "stability": "stable" } }, - "description": "Enables you to submit a request with a basic auth header to authenticate a user and retrieve information about the authenticated user.\nA successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.\nIf the user cannot be authenticated, this API returns a 401 status code.", + "description": "Authenticate a user.\nAuthenticates a user and returns information about the authenticated user.\nInclude the user information in a [basic auth header](https://en.wikipedia.org/wiki/Basic_access_authentication).\nA successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.\nIf the user cannot be authenticated, this API returns a 401 status code.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-authenticate.html", "name": "security.authenticate", "request": { @@ -8396,7 +8396,7 @@ "stability": "stable" } }, - "description": "Creates an API key for access without requiring basic authentication.\nA successful request returns a JSON structure that contains the API key, its unique id, and its name.\nIf applicable, it also returns expiration information for the API key in milliseconds.\nNOTE: By default, API keys never expire. You can specify expiration information when you create the API keys.", + "description": "Create an API key.\nCreates an API key for access without requiring basic authentication.\nA successful request returns a JSON structure that contains the API key, its unique id, and its name.\nIf applicable, it also returns expiration information for the API key in milliseconds.\nNOTE: By default, API keys never expire. You can specify expiration information when you create the API keys.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-create-api-key.html", "name": "security.create_api_key", "privileges": { @@ -8440,7 +8440,7 @@ "stability": "stable" } }, - "description": "Retrieves information for one or more API keys.\nNOTE: If you have only the `manage_own_api_key` privilege, this API returns only the API keys that you own.\nIf you have `read_security`, `manage_api_key` or greater privileges (including `manage_security`), this API returns all API keys regardless of ownership.", + "description": "Get API key information.\nRetrieves information for one or more API keys.\nNOTE: If you have only the `manage_own_api_key` privilege, this API returns only the API keys that you own.\nIf you have `read_security`, `manage_api_key` or greater privileges (including `manage_security`), this API returns all API keys regardless of ownership.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-api-key.html", "name": "security.get_api_key", "privileges": { @@ -8481,7 +8481,7 @@ "stability": "stable" } }, - "description": "Determines whether the specified user has a specified list of privileges.", + "description": "Check user privileges.\nDetermines whether the specified user has a specified list of privileges.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-has-privileges.html", "name": "security.has_privileges", "request": { @@ -8527,7 +8527,7 @@ "stability": "stable" } }, - "description": "Invalidates one or more API keys.\nThe `manage_api_key` privilege allows deleting any API keys.\nThe `manage_own_api_key` only allows deleting API keys that are owned by the user.\nIn addition, with the `manage_own_api_key` privilege, an invalidation request must be issued in one of the three formats:\n- Set the parameter `owner=true`.\n- Or, set both `username` and `realm_name` to match the user’s identity.\n- Or, if the request is issued by an API key, i.e. an API key invalidates itself, specify its ID in the `ids` field.", + "description": "Invalidate API keys.\nInvalidates one or more API keys.\nThe `manage_api_key` privilege allows deleting any API keys.\nThe `manage_own_api_key` only allows deleting API keys that are owned by the user.\nIn addition, with the `manage_own_api_key` privilege, an invalidation request must be issued in one of the three formats:\n- Set the parameter `owner=true`.\n- Or, set both `username` and `realm_name` to match the user’s identity.\n- Or, if the request is issued by an API key, i.e. an API key invalidates itself, specify its ID in the `ids` field.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-invalidate-api-key.html", "name": "security.invalidate_api_key", "privileges": { @@ -8571,7 +8571,7 @@ "stability": "stable" } }, - "description": "Retrieves information for API keys in a paginated manner. You can optionally filter the results with a query.", + "description": "Query API keys.\nRetrieves a paginated list of API keys and their information. You can optionally filter the results with a query.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-query-api-key.html", "name": "security.query_api_keys", "privileges": { @@ -8616,7 +8616,7 @@ "stability": "stable" } }, - "description": "Updates attributes of an existing API key.\nUsers can only update API keys that they created or that were granted to them.\nUse this API to update API keys created by the create API Key or grant API Key APIs.\nIf you need to apply the same update to many API keys, you can use bulk update API Keys to reduce overhead.\nIt’s not possible to update expired API keys, or API keys that have been invalidated by invalidate API Key.\nThis API supports updates to an API key’s access scope and metadata.\nThe access scope of an API key is derived from the `role_descriptors` you specify in the request, and a snapshot of the owner user’s permissions at the time of the request.\nThe snapshot of the owner’s permissions is updated automatically on every call.\nIf you don’t specify `role_descriptors` in the request, a call to this API might still change the API key’s access scope.\nThis change can occur if the owner user’s permissions have changed since the API key was created or last modified.\nTo update another user’s API key, use the `run_as` feature to submit a request on behalf of another user.\nIMPORTANT: It’s not possible to use an API key as the authentication credential for this API.\nTo update an API key, the owner user’s credentials are required.", + "description": "Update an API key.\nUpdates attributes of an existing API key.\nUsers can only update API keys that they created or that were granted to them.\nUse this API to update API keys created by the create API Key or grant API Key APIs.\nIf you need to apply the same update to many API keys, you can use bulk update API Keys to reduce overhead.\nIt’s not possible to update expired API keys, or API keys that have been invalidated by invalidate API Key.\nThis API supports updates to an API key’s access scope and metadata.\nThe access scope of an API key is derived from the `role_descriptors` you specify in the request, and a snapshot of the owner user’s permissions at the time of the request.\nThe snapshot of the owner’s permissions is updated automatically on every call.\nIf you don’t specify `role_descriptors` in the request, a call to this API might still change the API key’s access scope.\nThis change can occur if the owner user’s permissions have changed since the API key was created or last modified.\nTo update another user’s API key, use the `run_as` feature to submit a request on behalf of another user.\nIMPORTANT: It’s not possible to use an API key as the authentication credential for this API.\nTo update an API key, the owner user’s credentials are required.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-update-api-key.html", "name": "security.update_api_key", "privileges": { @@ -9137,7 +9137,7 @@ "stability": "experimental" } }, - "description": "Returns information about a task.", + "description": "Get task information.\nReturns information about the tasks currently executing in the cluster.", "docId": "tasks", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/tasks.html", "name": "tasks.get", @@ -11158,7 +11158,7 @@ } } }, - "description": "Performs multiple indexing or delete operations in a single API call.\nThis reduces overhead and can greatly increase indexing speed.", + "description": "Bulk index or delete documents.\nPerforms multiple indexing or delete operations in a single API call.\nThis reduces overhead and can greatly increase indexing speed.", "generics": [ { "name": "TDocument", @@ -11308,7 +11308,7 @@ } } ], - "specLocation": "_global/bulk/BulkRequest.ts#L32-L103" + "specLocation": "_global/bulk/BulkRequest.ts#L32-L104" }, { "body": { @@ -12595,7 +12595,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", + "description": "Delete component templates.\nDeletes component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", "inherits": { "type": { "name": "RequestBase", @@ -12649,7 +12649,7 @@ } } ], - "specLocation": "cluster/delete_component_template/ClusterDeleteComponentTemplateRequest.ts#L24-L54" + "specLocation": "cluster/delete_component_template/ClusterDeleteComponentTemplateRequest.ts#L24-L55" }, { "body": { @@ -12676,7 +12676,7 @@ "body": { "kind": "no_body" }, - "description": "Returns information about whether a particular component template exist", + "description": "Check component templates.\nReturns information about whether a particular component template exists.", "inherits": { "type": { "name": "RequestBase", @@ -12730,7 +12730,7 @@ } } ], - "specLocation": "cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts#L24-L53" + "specLocation": "cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts#L24-L55" }, { "body": { @@ -12750,7 +12750,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves information about component templates.", + "description": "Get component templates.\nRetrieves information about component templates.", "inherits": { "type": { "name": "RequestBase", @@ -12839,7 +12839,7 @@ } } ], - "specLocation": "cluster/get_component_template/ClusterGetComponentTemplateRequest.ts#L24-L65" + "specLocation": "cluster/get_component_template/ClusterGetComponentTemplateRequest.ts#L24-L66" }, { "body": { @@ -13040,7 +13040,7 @@ } ] }, - "description": "Creates or updates a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.", + "description": "Create or update a component template.\nCreates or updates a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.", "inherits": { "type": { "name": "RequestBase", @@ -13094,7 +13094,7 @@ } } ], - "specLocation": "cluster/put_component_template/ClusterPutComponentTemplateRequest.ts#L25-L93" + "specLocation": "cluster/put_component_template/ClusterPutComponentTemplateRequest.ts#L25-L94" }, { "body": { @@ -16396,7 +16396,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes a stored script or search template.", + "description": "Delete a script or search template.\nDeletes a stored script or search template.", "inherits": { "type": { "name": "RequestBase", @@ -16450,7 +16450,7 @@ } } ], - "specLocation": "_global/delete_script/DeleteScriptRequest.ts#L24-L51" + "specLocation": "_global/delete_script/DeleteScriptRequest.ts#L24-L52" }, { "body": { @@ -18857,7 +18857,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves a stored script or search template.", + "description": "Get a script or search template.\nRetrieves a stored script or search template.", "inherits": { "type": { "name": "RequestBase", @@ -18897,7 +18897,7 @@ } } ], - "specLocation": "_global/get_script/GetScriptRequest.ts#L24-L41" + "specLocation": "_global/get_script/GetScriptRequest.ts#L24-L42" }, { "body": { @@ -34415,7 +34415,7 @@ } ] }, - "description": "Creates or updates a stored script or search template.", + "description": "Create or update a script or search template.\nCreates or updates a stored script or search template.", "inherits": { "type": { "name": "RequestBase", @@ -34481,7 +34481,7 @@ } } ], - "specLocation": "_global/put_script/PutScriptRequest.ts#L25-L64" + "specLocation": "_global/put_script/PutScriptRequest.ts#L25-L65" }, { "body": { @@ -35807,7 +35807,7 @@ } ] }, - "description": "Runs a script and returns a result.", + "description": "Run a script.\nRuns a script and returns a result.", "inherits": { "type": { "name": "RequestBase", @@ -35821,7 +35821,7 @@ }, "path": [], "query": [], - "specLocation": "_global/scripts_painless_execute/ExecutePainlessScriptRequest.ts#L24-L46" + "specLocation": "_global/scripts_painless_execute/ExecutePainlessScriptRequest.ts#L24-L47" }, { "body": { @@ -38617,7 +38617,7 @@ "body": { "kind": "no_body" }, - "description": "Enables you to submit a request with a basic auth header to authenticate a user and retrieve information about the authenticated user.\nA successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.\nIf the user cannot be authenticated, this API returns a 401 status code.", + "description": "Authenticate a user.\nAuthenticates a user and returns information about the authenticated user.\nInclude the user information in a [basic auth header](https://en.wikipedia.org/wiki/Basic_access_authentication).\nA successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.\nIf the user cannot be authenticated, this API returns a 401 status code.", "inherits": { "type": { "name": "RequestBase", @@ -38631,7 +38631,7 @@ }, "path": [], "query": [], - "specLocation": "security/authenticate/SecurityAuthenticateRequest.ts#L22-L30" + "specLocation": "security/authenticate/SecurityAuthenticateRequest.ts#L22-L32" }, { "body": { @@ -38876,7 +38876,7 @@ } ] }, - "description": "Creates an API key for access without requiring basic authentication.\nA successful request returns a JSON structure that contains the API key, its unique id, and its name.\nIf applicable, it also returns expiration information for the API key in milliseconds.\nNOTE: By default, API keys never expire. You can specify expiration information when you create the API keys.", + "description": "Create an API key.\nCreates an API key for access without requiring basic authentication.\nA successful request returns a JSON structure that contains the API key, its unique id, and its name.\nIf applicable, it also returns expiration information for the API key in milliseconds.\nNOTE: By default, API keys never expire. You can specify expiration information when you create the API keys.", "inherits": { "type": { "name": "RequestBase", @@ -38903,7 +38903,7 @@ } } ], - "specLocation": "security/create_api_key/SecurityCreateApiKeyRequest.ts#L26-L58" + "specLocation": "security/create_api_key/SecurityCreateApiKeyRequest.ts#L26-L59" }, { "body": { @@ -38991,7 +38991,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves information for one or more API keys.\nNOTE: If you have only the `manage_own_api_key` privilege, this API returns only the API keys that you own.\nIf you have `read_security`, `manage_api_key` or greater privileges (including `manage_security`), this API returns all API keys regardless of ownership.", + "description": "Get API key information.\nRetrieves information for one or more API keys.\nNOTE: If you have only the `manage_own_api_key` privilege, this API returns only the API keys that you own.\nIf you have `read_security`, `manage_api_key` or greater privileges (including `manage_security`), this API returns all API keys regardless of ownership.", "inherits": { "type": { "name": "RequestBase", @@ -39124,7 +39124,7 @@ } } ], - "specLocation": "security/get_api_key/SecurityGetApiKeyRequest.ts#L23-L86" + "specLocation": "security/get_api_key/SecurityGetApiKeyRequest.ts#L23-L87" }, { "body": { @@ -39205,7 +39205,7 @@ } ] }, - "description": "Determines whether the specified user has a specified list of privileges.", + "description": "Check user privileges.\nDetermines whether the specified user has a specified list of privileges.", "inherits": { "type": { "name": "RequestBase", @@ -39232,7 +39232,7 @@ } ], "query": [], - "specLocation": "security/has_privileges/SecurityHasPrivilegesRequest.ts#L25-L42" + "specLocation": "security/has_privileges/SecurityHasPrivilegesRequest.ts#L25-L44" }, { "body": { @@ -39408,7 +39408,7 @@ } ] }, - "description": "Invalidates one or more API keys.\nThe `manage_api_key` privilege allows deleting any API keys.\nThe `manage_own_api_key` only allows deleting API keys that are owned by the user.\nIn addition, with the `manage_own_api_key` privilege, an invalidation request must be issued in one of the three formats:\n- Set the parameter `owner=true`.\n- Or, set both `username` and `realm_name` to match the user’s identity.\n- Or, if the request is issued by an API key, i.e. an API key invalidates itself, specify its ID in the `ids` field.", + "description": "Invalidate API keys.\nInvalidates one or more API keys.\nThe `manage_api_key` privilege allows deleting any API keys.\nThe `manage_own_api_key` only allows deleting API keys that are owned by the user.\nIn addition, with the `manage_own_api_key` privilege, an invalidation request must be issued in one of the three formats:\n- Set the parameter `owner=true`.\n- Or, set both `username` and `realm_name` to match the user’s identity.\n- Or, if the request is issued by an API key, i.e. an API key invalidates itself, specify its ID in the `ids` field.", "inherits": { "type": { "name": "RequestBase", @@ -39422,7 +39422,7 @@ }, "path": [], "query": [], - "specLocation": "security/invalidate_api_key/SecurityInvalidateApiKeyRequest.ts#L23-L66" + "specLocation": "security/invalidate_api_key/SecurityInvalidateApiKeyRequest.ts#L23-L67" }, { "body": { @@ -39589,7 +39589,7 @@ } ] }, - "description": "Retrieves information for API keys in a paginated manner. You can optionally filter the results with a query.", + "description": "Query API keys.\nRetrieves a paginated list of API keys and their information. You can optionally filter the results with a query.", "inherits": { "type": { "name": "RequestBase", @@ -39660,7 +39660,7 @@ } } ], - "specLocation": "security/query_api_keys/QueryApiKeysRequest.ts#L26-L99" + "specLocation": "security/query_api_keys/QueryApiKeysRequest.ts#L26-L100" }, { "body": { @@ -39795,7 +39795,7 @@ } ] }, - "description": "Updates attributes of an existing API key.\nUsers can only update API keys that they created or that were granted to them.\nUse this API to update API keys created by the create API Key or grant API Key APIs.\nIf you need to apply the same update to many API keys, you can use bulk update API Keys to reduce overhead.\nIt’s not possible to update expired API keys, or API keys that have been invalidated by invalidate API Key.\nThis API supports updates to an API key’s access scope and metadata.\nThe access scope of an API key is derived from the `role_descriptors` you specify in the request, and a snapshot of the owner user’s permissions at the time of the request.\nThe snapshot of the owner’s permissions is updated automatically on every call.\nIf you don’t specify `role_descriptors` in the request, a call to this API might still change the API key’s access scope.\nThis change can occur if the owner user’s permissions have changed since the API key was created or last modified.\nTo update another user’s API key, use the `run_as` feature to submit a request on behalf of another user.\nIMPORTANT: It’s not possible to use an API key as the authentication credential for this API.\nTo update an API key, the owner user’s credentials are required.", + "description": "Update an API key.\nUpdates attributes of an existing API key.\nUsers can only update API keys that they created or that were granted to them.\nUse this API to update API keys created by the create API Key or grant API Key APIs.\nIf you need to apply the same update to many API keys, you can use bulk update API Keys to reduce overhead.\nIt’s not possible to update expired API keys, or API keys that have been invalidated by invalidate API Key.\nThis API supports updates to an API key’s access scope and metadata.\nThe access scope of an API key is derived from the `role_descriptors` you specify in the request, and a snapshot of the owner user’s permissions at the time of the request.\nThe snapshot of the owner’s permissions is updated automatically on every call.\nIf you don’t specify `role_descriptors` in the request, a call to this API might still change the API key’s access scope.\nThis change can occur if the owner user’s permissions have changed since the API key was created or last modified.\nTo update another user’s API key, use the `run_as` feature to submit a request on behalf of another user.\nIMPORTANT: It’s not possible to use an API key as the authentication credential for this API.\nTo update an API key, the owner user’s credentials are required.", "inherits": { "type": { "name": "RequestBase", @@ -39822,7 +39822,7 @@ } ], "query": [], - "specLocation": "security/update_api_key/Request.ts#L26-L65" + "specLocation": "security/update_api_key/Request.ts#L26-L66" }, { "body": { @@ -41344,7 +41344,7 @@ "body": { "kind": "no_body" }, - "description": "Returns information about a task.", + "description": "Get task information.\nReturns information about the tasks currently executing in the cluster.", "inherits": { "type": { "name": "RequestBase", @@ -41398,7 +41398,7 @@ } } ], - "specLocation": "tasks/get/GetTaskRequest.ts#L24-L50" + "specLocation": "tasks/get/GetTaskRequest.ts#L24-L52" }, { "body": {