openapi: 3.0.1
info:
contact:
email: support@aiven.io
name: Aiven support team
url: https://aiven.io/support-services
title: Aiven API Documentation Account Service:_OpenSearch API
version: v1
x-logo:
altText: Aiven logo
backgroundColor: '#fafafa'
href: https://api.aiven.io/doc
url: https://aiven.io/assets/img/aiven-logo.png
description: "# Introduction\n\n[Direct link to openapi.json](https://api.aiven.io/doc/openapi.json) for use with external tools\n\n[Aiven](https://aiven.io) is a modern fully-managed open source data platform for streaming, storing, and analyzing data on any public cloud. On Aiven Platform, you can operate your data infrastructure with a few devops tools: [Aiven Console](https://console.aiven.io/), [Aiven Terraform Provider](https://aiven.io/docs/tools/terraform), [Aiven CLI](https://github.com/aiven/aiven-client), and [Aiven Operator for Kubernetes](https://github.com/aiven/aiven-operator). All of them are built on an open secure powerful REST API for integration with custom tooling.\n\nThe Aiven [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer) API\nprovides programmatic access to Aiven.io services. To call the Aiven API, you can use either CLI tools (for example, `cURL` or [Aiven CLI client](https://aiven.io/docs/tools/cli)) or GUI tools, such as the [Aiven public API Postman collection](https://www.postman.com/aiven-apis).\n\nThis Aiven API documentation will help you operate your Aiven organization, projects, or services programmatically by integrating your applications and processes with Aiven.\n\n# Description\n\nAiven's APIs ([Application Programming Interfaces](https://en.wikipedia.org/wiki/API)) power its platform for data management. Aiven has a number of REST APIs that can help you build strong and robust data infrastructure for your applications.\n\nThe Aiven API is organized around core resources. Each core resource has multiple endpoints, which can be interacted with using different HTTP methods.\n\n## Core resources\n\n### Platform APIs\n\n
\n - Account
\n - Operations on the organization level related to accounts, projects, teams, users, invites, billing groups, payment methods, credit cards, authentication methods, and more
\n - User
\n - Operations related to users and users' profiles, access, authentication, authorization, user management, and more
\n - Project
\n - General operations on projects related to users, VPCs, invitations, alerts, peering connections, and more
\n - BillingGroup
\n - Operation on invoices, billing groups' credits and events
\n - Support ticket
\n - Operations on support tickets: listing, creating, looping users in
\n
\n\n### Services APIs\n\n\n - Service
\n - All general (non-service-specific) operations on the service level: service creation, termination, configuration, updates, information retrieval, reset, and more
\n - Service Integrations
\n - Operations related to integrating services and managing service integrations
\n - Service: ClickHouse
\n - ClickHouse-specific operations on queries and databases
\n - Service: Flink
\n - Operations on Flink queries, jobs, and applications
\n - Service: Kafka
\n - Kafka and Kafka Connect specific operations on connectors, ACL entries, quotas, topics, topic messages, schema registry, and more
\n - Service: Kafka MirrorMaker
\n - Operations on replication flows
\n - Service: MySQL
\n - Fetching service query statistics
\n - Service: OpenSearch
\n - Operations on ACL configuration, security administration and configuration
\n - Service: PostgreSQL
\n - Operations on extensions, service query statistics, and connection pools
\n
\n\n# Requests\n\nThere are multiple ways you can interact with the Aiven API over HTTP. You can access it by sending requests from a client (for example, a web browser) to the Aiven's server. In this API reference, you'll find code examples of how to do that using `cURL` and a few different client libraries (programming languages).\n\nTo send an API request, you need to specify the following:\n\n* HTTP method\n* Path\n* Request headers\n\n Typically, `content-type` needs to be set to `application/json`: `content-type: application/json`. There are a few exceptions though.\n\n* Path, query, or body parameters (either required or optional).\n\n```bash\ncurl --request POST \\\n --url https://api.aiven.io/v1/project/{project}/vpcs \\\n --header 'Authorization: aivenv1 REPLACE_BEARER_TOKEN' \\\n --header 'content-type: application/json' \\\n --data\n '{\n \"cloud_name\": \"string\",\n \"network_cidr\": \"string\",\n \"peering_connections\": [\n {\n \"peer_azure_app_id\": \"string\",\n \"peer_azure_tenant_id\": \"string\",\n \"peer_cloud_account\": \"string\",\n \"peer_region\": \"string\",\n \"peer_resource_group\": \"string\",\n \"peer_vpc\": \"string\",\n \"user_peer_network_cidrs\": [\n \"string\"\n ]\n }\n ]\n }'\n```\n\n# Responses\n\nUpon receiving and processing a request, the Aiven API returns the response status code, response headers, and a response body in the `JSON` format. Response bodies include different properties, which can be either required or optional, for example, the ``message`` property, which is an optional human-readable information on the result of the action (deleted, created, or updated).\n\n```json\n{\n \"cloud_name\": \"string\",\n \"create_time\": \"string\",\n \"message\": \"string\",\n \"network_cidr\": \"string\",\n \"peering_connections\": [\n { ... }\n ],\n \"pending_build_only_peering_connections\": \"string\",\n \"project_vpc_id\": \"string\",\n \"state\": \"ACTIVE\",\n \"update_time\": \"string\"\n}\n```\n\n## Successful responses\n\nA successful API response returns an HTTP result code between 200 and 299.\n\nExample of the ``created`` response\n\n```json\n {\n \"service\": {\n \"service_name\": \"foobar\",\n ...\n }\n }\n```\n\n## Failed responses\n\nA failed API response returns a HTTP code greater or equal to 400. Additionally, the response may return a list of errors in the response body as JSON, for example\n\n```json\n{\n \"errors\": [\n {\n \"error_code\": \"authentication_failed\",\n \"message\": \"Authentication failed\",\n \"status\": 403,\n \"metadata\": {\n ...\n }\n }\n ],\n \"message\": \"Authentication failed\"\n}\n```\n\n> For information on errors' properties and error codes, check [Errors](/doc/openapi/openapi-description#errors).\n\n# Get started\n\nCheck out how to start using the Aiven API either in [API quick start](https://aiven.io/docs/tools/api#api-quickstart) or [Your first API call](https://aiven.io/blog/your-first-aiven-api-call).\n\n## Authentication\n\n\n\n# Errors\n\nWhen working with the Aiven API, you may encounter different error responses when you attempt to perform operations that can fail. For example, trying to enable writes for a database that has been powered off would lead to the following error response:\n\n```json\n{\n \"errors\": [\n {\n \"error_code\": \"not_powered\",\n \"message\": \"Database not powered on\",\n \"status\": 409\n }\n ],\n \"message\": \"Database not powered on\"\n}\n```\n\n## Check a response for errors\n\nIf a request fails with a HTTP code greater or equal to 400, it returns a list of errors in the response body as JSON. `errors` objects are embedded in the failed API responses.\n\n```json\n{\n \"errors\": [\n {\n \"error_code\": \"account_not_found\",\n \"message\": \"Account does not exist\",\n \"status\": 404\n }\n ],\n \"message\": \"Account does not exist\"\n}\n```\n\n## Errors' properties\n\nIn an API response, one or more errors may be included in the ``errors`` array of objects. Each error object may contain a few properties:\n\n* ``status`` (required) is an HTTP error code, which can be used to programmatically identify the error type.\n\n * ``200`` <= ``status``< ``300`` means a successful request.\n * ``300`` <= ``status`` <= ``500`` means a failed request.\n\n ``errors`` can have the following HTTPS status codes:\n\n * 200 - OK\n * 201 - Created\n * 400 - Bad Request\n * 401 - Unauthorized\n * 403 - Forbidden\n * 404 - Not found\n * 405 - Method Not Allowed\n * 409 - Conflict\n * 500 - Internal Server Error\n\n* ``message`` (required) is human-readable information on the error.\n* ``error_code`` is a machine-readable information on the error (see [Error codes](/doc/openapi/openapi-description#error-codes)).\n\n## Error codes\n\nMachine-readable ``error_code`` fields are progressively added to Aiven endpoints to allow you to identify different failure cases programmatically. Currently, the supported values are the following:\n\n- `account_already_exists`\n- `account_already_has_organization`\n- `account_and_project_do_not_match`\n- `account_and_project_must_belong_same_tenant`\n- `account_cannot_be_own_ancestor`\n- `account_must_have_enabled_authentication_method`\n- `account_not_found`\n- `account_team_not_found`\n- `account_unit_cannot_create_for_personal_tier`\n- `account_unit_cannot_have_billing_group`\n- `account_with_child_accounts_cannot_be_deleted`\n- `account_with_projects_cannot_be_deleted`\n- `action_forbidden_for_application_users`\n- `action_forbidden_for_managed_users`\n- `action_forbidden_for_marketplace_users`\n- `action_forbidden_for_scim_users`\n- `action_forbidden_for_timescale_users`\n- `action_forbidden_missing_governance_usergroup`\n- `action_forbidden_on_application_users`\n- `action_forbidden_on_topic_request`\n- `action_forbidden_on_unmanaged_users`\n- `acu_billing_not_allowed`\n- `address_already_belongs_to_organization`\n- `address_in_use`\n- `address_not_found`\n- `api_client_ip_allowlist_blocks_caller`\n- `approval_forbidden_on_topic_request`\n- `approval_missing_on_request`\n- `auth_token_max_age_too_low`\n- `authentication_method_disable_current_not_allowed`\n- `authentication_method_does_not_allow_auto_join_user_group`\n- `authentication_method_limit_reached`\n- `authentication_method_not_found`\n- `backup_failed`\n- `bad_request`\n- `billing_address_not_found`\n- `billing_customer_id_not_found`\n- `billing_group_not_found`\n- `billing_group_organization_active_trial`\n- `billing_group_owning_account_must_be_organization`\n- `billing_metronome_support_contract_not_found`\n- `ca_version_not_in_sequence`\n- `cannot_delete_active_managed_users`\n- `cannot_delete_users_with_organizations_memberships`\n- `cannot_move_project_not_assigned_to_organization`\n- `cannot_remove_managed_users_from_organization`\n- `cannot_set_groups_managed_by_scim_as_auto_join_group`\n- `client_ip_address_policy_violation`\n- `credit_card_not_found`\n- `credit_memo_not_found`\n- `custom_cloud_environment_cloud_not_supported`\n- `custom_cloud_environment_internal`\n- `custom_cloud_environment_invalid_iam_role_arn`\n- `custom_cloud_environment_missing_configuration`\n- `custom_cloud_environment_not_found`\n- `custom_cloud_environment_region_not_supported`\n- `database_not_found`\n- `decline_forbidden_on_topic_request`\n- `deleting_forbidden_on_governance_request`\n- `deleting_forbidden_on_topic_request`\n- `discount_not_found`\n- `feature_not_enabled`\n- `free_plans_in_high_demand_and_unavailable`\n- `free_tier_restricted`\n- `free_trial_extensions_not_available`\n- `free_trial_max_extended`\n- `free_trial_not_active`\n- `free_trial_not_available`\n- `governance_access_no_permission_on_project`\n- `governance_access_not_found`\n- `governance_configuration_already_exists`\n- `governance_configuration_not_found`\n- `governance_group_not_found`\n- `governance_invalid_service_type`\n- `governance_request_already_in_progress`\n- `governance_request_deleted`\n- `idp_no_domains_linked`\n- `index_close_failed`\n- `index_not_found`\n- `internal_server_error`\n- `invalid_backup_configuration`\n- `invalid_cmk_id`\n- `invalid_currency_code`\n- `invalid_date_format`\n- `invalid_email_format`\n- `invalid_governance_group_provided`\n- `invalid_kafka_topic_request_type`\n- `invalid_os_migration_command`\n- `invalid_owner_user_group`\n- `invalid_private_access_settings`\n- `invalid_scim_user_state_update`\n- `invalid_service_type`\n- `invalid_vcs_type`\n- `invitation_expired`\n- `invitation_not_found`\n- `invoice_lines_not_supported`\n- `invoice_not_found`\n- `ip_address_not_present`\n- `ip_address_not_valid`\n- `kafka_acl_not_supported`\n- `kafka_console_governance_enabled`\n- `kafka_governance_not_available`\n- `kafka_governance_not_enabled`\n- `kafka_governance_policy_incomplete`\n- `kafka_partition_reassignment_in_progress`\n- `kafka_policy_violation`\n- `kafka_service_unavailable`\n- `kafka_terraform_governance_enabled`\n- `kafka_topic_already_exists`\n- `kafka_topic_invalid_config`\n- `kafka_topic_not_found`\n- `kafka_topic_not_synchronized`\n- `kafka_topic_queued_for_deletion`\n- `kafka_topic_reserved`\n- `marketplace_aws_customer_or_product_details_not_found`\n- `marketplace_subscription_already_linked_to_organization`\n- `marketplace_subscription_link_expired`\n- `marketplace_subscription_no_access`\n- `metadata_validation_failed`\n- `mfa_required_by_organization`\n- `mp_account_with_active_subscription_deleted`\n- `mp_account_with_commitment_deleted`\n- `mp_account_with_support_contract_deleted`\n- `mp_subscription_not_found`\n- `nested_account_cannot_have_authentication_method`\n- `nested_account_cannot_have_user_groups`\n- `new_subnet_id_required`\n- `no_failed_os_migration`\n- `node_prune_version_not_updated`\n- `not_powered`\n- `opensearch_delete_system_index`\n- `opensearch_internal_server_error`\n- `opensearch_service_unavailable`\n- `opensearch_too_many_requests`\n- `optimization_failed`\n- `optimization_not_found`\n- `organization_aiven_enterprise_contract_denied`\n- `organization_aiven_enterprise_contract_feature_denied`\n- `organization_aiven_enterprise_denied`\n- `organization_aiven_enterprise_organization_required`\n- `organization_cannot_exist_without_root_account`\n- `organization_domain_already_linked`\n- `organization_domain_not_found`\n- `organization_domain_not_root`\n- `organization_domain_verification_failed`\n- `organization_has_active_addresses`\n- `organization_has_active_payment_methods`\n- `organization_kafka_topics_invalid_filters`\n- `organization_mismatch`\n- `organization_must_have_one_super_admin`\n- `organization_not_found`\n- `organization_pending_support_contract_already_exists`\n- `organization_support_contract_tier_not_supported`\n- `organization_tier_downgrade_not_allowed`\n- `organization_user_not_found`\n- `orphaned_project_not_allowed`\n- `parent_account_cannot_be_own_ancestor`\n- `parent_account_not_found`\n- `parent_account_tenant_invalid`\n- `parent_account_too_deep`\n- `payment_method_not_found`\n- `permission_denied`\n- `pg_editor_readonly_violation`\n- `pg_pool_already_exists`\n- `pg_pool_invalid_database`\n- `pg_pool_invalid_name`\n- `pg_pool_not_found`\n- `pg_pool_not_supported`\n- `pg_pool_pinned_pools_not_enabled`\n- `pg_pool_requires_pinned_pools`\n- `pg_pool_too_big`\n- `pg_pool_too_many`\n- `pg_publication_not_found`\n- `pg_replication_slot_not_found`\n- `pg_scram_not_allowed`\n- `project_account_not_active`\n- `project_already_exists`\n- `project_belongs_to_account_billing_group_must_use_api`\n- `project_does_not_exist`\n- `project_has_no_such_user`\n- `project_limitation_not_found`\n- `project_move_invalid`\n- `project_move_organizations_internal_config_not_match`\n- `project_not_found`\n- `project_without_billing_group_must_be_assigned_from_account`\n- `query_validation_failed`\n- `replication_already_exists`\n- `replication_config_invalid`\n- `replication_not_found`\n- `replication_service_not_found`\n- `repository_not_found`\n- `request_already_exists`\n- `request_forbidden`\n- `request_not_found`\n- `request_operation_already_exists`\n- `request_operation_not_found`\n- `resource_managed_by_governance`\n- `resource_managed_by_scim`\n- `resource_not_managed_by_scim`\n- `retired_api_endpoint`\n- `root_account_required`\n- `same_organization_required`\n- `schema_insights_failed`\n- `service_acl_not_found`\n- `service_acl_too_many`\n- `service_does_not_exist`\n- `service_governance_not_enabled`\n- `service_integration_endpoint_not_found`\n- `service_integration_not_found`\n- `service_integration_project_mismatch_source_destination`\n- `service_is_upgrade_pipeline_source`\n- `service_logs_backend_timeout`\n- `service_logs_backend_unavailable`\n- `service_maintenance_required`\n- `service_not_found`\n- `service_type_not_allowed`\n- `service_type_version_pin_locked`\n- `shipping_address_not_found`\n- `signup_welcome_invalid_key`\n- `snapshot_creation_failed`\n- `snapshot_deletion_failed`\n- `snapshot_not_found`\n- `snapshot_restoration_failed`\n- `stripe_customer_owning_account_must_be_organization`\n- `support_contract_and_account_must_be_in_same_organization`\n- `support_contract_earliest_cancellation_date_later_than_end_date`\n- `support_contract_must_have_billing_group`\n- `support_contract_null_tier`\n- `team_limit_exceeded`\n- `team_names_must_be_unique`\n- `tenant_mismatch`\n- `topic_not_found`\n- `unable_to_parse_query`\n- `unit_cannot_be_moved_out_of_organization`\n- `unknown_user_sso_login_attempt`\n- `unsupported_resource_type`\n- `upgrade_pipeline_no_nodes`\n- `upgrade_pipeline_no_validation`\n- `upgrade_pipeline_not_enabled_for_project`\n- `upgrade_pipeline_service_not_destination`\n- `upgrade_pipeline_service_not_found`\n- `upgrade_step_destination_already_has_source`\n- `upgrade_step_destination_service_not_found`\n- `upgrade_step_exceeds_max_chain_length`\n- `upgrade_step_not_found`\n- `upgrade_step_service_type_mismatch`\n- `upgrade_step_source_service_not_found`\n- `upgrade_step_unsupported_service_type`\n- `upgrade_step_validation_not_possible_due_to_service_state`\n- `upgrade_step_would_create_cycle`\n- `upgrade_validation_already_exists`\n- `user_already_in_organization`\n- `user_already_invited_to_organization`\n- `user_cant_login`\n- `user_config_2fa_otp_verification_failed`\n- `user_deactivated`\n- `user_domain_does_not_belong_to_organization_or_no_linked_auth_method`\n- `user_group_names_must_be_unique`\n- `user_group_not_found`\n- `user_groups_belong_to_different_accounts`\n- `user_groups_must_be_from_same_account`\n- `user_has_no_access_to_billing_info`\n- `user_has_no_access_to_project_with_current_authentication_method`\n- `user_has_to_sign_in_with_non_account_authentication_method`\n- `user_has_too_many_disk_addition_requests`\n- `user_is_internal_user`\n- `user_not_account_owner`\n- `user_not_account_owner_of_billing_group`\n- `user_not_account_owner_of_parent_account`\n- `user_not_admin_of_account_billing_group`\n- `user_not_application_user`\n- `user_not_found`\n- `user_not_managed_by_organization`\n- `user_not_organization_admin`\n- `user_not_signed_in_with_account_authentication_method`\n- `user_oauth_authentication_method_not_allowed`\n- `user_password_authentication_method_not_allowed`\n- `user_password_compromised`\n- `user_password_not_found`\n- `user_personal_token_allowed_authentication_methods_cannot_be_disabled`\n- `user_personal_token_not_allowed`\n- `user_personal_tokens_cannot_be_disabled`\n- `user_role_not_allowed_to_perform_operation`\n- `user_saml_authentication_method_not_allowed`\n- `user_weblink_action_expired`\n- `username_is_invalid`\n- `username_is_reserved`\n- `users_belong_to_different_tenant_from_user_group_account`\n- `vcs_integration_installation_not_found_or_not_accessible`\n- `vcs_integration_not_found`\n- `vpc_id_and_subnet_id_required`\n- `webhook_invalid_event_data`\n- `webhook_unauthorized`\n"
servers:
- url: https://api.aiven.io/v1
tags:
- name: Service:_OpenSearch
x-displayName: 'Service: OpenSearch'
paths:
/project/{project}/service/{service_name}/opensearch/acl:
get:
summary: Show OpenSearch ACL configuration
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchAclGet
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchAclGetResponse'
security:
- tokenAuth: []
oauth2:
- services:read
post:
summary: Set OpenSearch ACL configuration
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchAclSet
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchAclSetRequestBody'
example:
opensearch_acl_config:
acls:
- rules:
- index: ind*
permission: deny
username: admin*
enabled: false
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchAclSetResponse'
security:
- tokenAuth: []
oauth2:
- services:write
put:
summary: Update OpenSearch ACL configuration
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchAclUpdate
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchAclUpdateRequestBody'
example:
opensearch_acl_config:
acls:
- rules:
- index: ind*
permission: deny
username: admin*
enabled: false
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchAclUpdateResponse'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/opensearch/{index_pattern}/_close:
post:
summary: Open OpenSearch indices
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchIndexClose
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/index_pattern'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexCloseResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- index_close_failed
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'index_close_failed: Index close failed'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/index/close_multiple:
post:
summary: Close multiple OpenSearch indexes
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchIndexCloseMultiple
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexCloseMultipleRequestBody'
example:
indices:
- index1
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexCloseMultipleResponse'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/index/{index_pattern}:
delete:
summary: Delete an OpenSearch index
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchIndexDelete
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/index_pattern'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexDeleteResponse'
'403':
description: Operation not allowed
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_delete_system_index
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_delete_system_index: Index can not be deleted through Aiven API'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- index_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'index_not_found: Index not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/index:
get:
summary: List OpenSearch indexes
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchIndexList
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexListResponse'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/{index_pattern}/_open:
post:
summary: Open OpenSearch indices
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchIndexOpen
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/index_pattern'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexOpenResponse'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/index/open_multiple:
post:
summary: Open multiple OpenSearch indexes
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchIndexOpenMultiple
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexOpenMultipleRequestBody'
example:
indices:
- index1
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchIndexOpenMultipleResponse'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/opensearch/security:
get:
summary: Show OpenSearch security configuration status
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchSecurityGet
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchSecurityGetResponse'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/security/admin:
put:
summary: Change Opensearch Security Admin password
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchSecurityReset
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchSecurityResetRequestBody'
example:
admin_password: h3.2aD!z2
new_password: h3.2aD!z2
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchSecurityResetResponse'
security:
- tokenAuth: []
oauth2:
- services:write
post:
summary: Enable Opensearch Security Admin by setting the password
tags:
- Service:_OpenSearch
operationId: ServiceOpenSearchSecuritySet
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchSecuritySetRequestBody'
example:
admin_password: h3.2aD!z2
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpenSearchSecuritySetResponse'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/{snapshot_name}:
post:
summary: Create a snapshot to custom repository
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoCreateSnapshot
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
- $ref: '#/components/parameters/snapshot_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoCreateSnapshotRequestBody'
example:
ignore_unavailable: false
include_global_state: true
indices: '*'
partial: false
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoCreateSnapshotResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- snapshot_creation_failed
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'snapshot_creation_failed: Snapshot creation failed'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
delete:
summary: Delete a snapshot from custom repository
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoDeleteSnapshot
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
- $ref: '#/components/parameters/snapshot_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoDeleteSnapshotResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- snapshot_deletion_failed
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'snapshot_deletion_failed: Unable to delete snapshot'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
get:
summary: Show snapshot details
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoShowSnapshot
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
- $ref: '#/components/parameters/snapshot_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoShowSnapshotResponse'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/_all:
get:
summary: List all snapshots in custom repository
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoListSnapshots
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoListSnapshotsResponse'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/_verify:
post:
summary: Verify custom repo name is allowed
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoNameVerify
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoNameVerifyResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- snapshot_deletion_failed
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'snapshot_deletion_failed: Unable to delete snapshot'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/{snapshot_name}/_restore:
post:
summary: Restore a snapshot from custom repository
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoRestoreSnapshot
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
- $ref: '#/components/parameters/snapshot_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoRestoreSnapshotRequestBody'
example:
ignore_index_settings: index.number_of_replicas
ignore_unavailable: false
include_aliases: false
include_global_state: false
index_settings: index.number_of_replicas=1
indices: '*'
partial: false
rename_alias_pattern: (.+)
rename_alias_replacement: $1_restored
rename_pattern: (.+)
rename_replacement: $1_restored
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoRestoreSnapshotResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- snapshot_restoration_failed
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'snapshot_restoration_failed: Snapshot restoration failed'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'500':
description: Server got itself in trouble
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_internal_server_error
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_internal_server_error: OpenSearch service is not able to process the request'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/{snapshot_name}/_restore_check:
post:
summary: Dry run endpoint to check for conflicted indices before restoring a snapshot
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoRestoreSnapshotCheck
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
- $ref: '#/components/parameters/snapshot_name'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoRestoreSnapshotCheckRequestBody'
example:
ignore_unavailable: false
include_aliases: false
indices: '*'
rename_pattern: (.+)
rename_replacement: $1_restored
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoRestoreSnapshotCheckResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- snapshot_restoration_failed
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'snapshot_restoration_failed: Snapshot restoration failed'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'500':
description: Server got itself in trouble
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_internal_server_error
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_internal_server_error: OpenSearch service is not able to process the request'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:write
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/{snapshot_name}/_status:
get:
summary: Show full status of a snapshot in custom repository
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoShowSnapshotStatus
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
- $ref: '#/components/parameters/snapshot_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoShowSnapshotStatusResponse'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/_snapshot/{repository_name}/_status:
get:
summary: List currently running snapshots for a custom repository
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchCustomRepoSnapshotsInProgress
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
- $ref: '#/components/parameters/repository_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchCustomRepoSnapshotsInProgressResponse'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/_snapshot:
get:
summary: List custom repositories defined for OpenSearch service
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchListCustomRepos
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchListCustomReposResponse'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/_snapshot/restoration_in_progress:
get:
summary: List restorations in progress for this service
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchListRestorationsInProgress
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchListRestorationsInProgressResponse'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- repository_not_found
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'repository_not_found: Repository not found'
'409':
description: Request conflict
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- not_powered
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'not_powered: Service is not powered'
'429':
description: The user has sent too many requests in a given amount of time ("rate limiting")
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_too_many_requests
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_too_many_requests: OpenSearch service is not able to process the request due to too many requests'
'502':
description: Invalid responses from another server/proxy
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- opensearch_service_unavailable
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'opensearch_service_unavailable: OpenSearch service is not able to process the request'
security:
- tokenAuth: []
oauth2:
- services:read
/project/{project}/service/{service_name}/opensearch/tiered-storage/summary:
get:
summary: Get OpenSearch tiered storage summary
tags:
- Service:_OpenSearch
operationId: ServiceOpensearchTieredStorageSummary
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_name'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceOpensearchTieredStorageSummaryResponse'
'404':
description: Resource not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
title: Human readable error message
errors:
type: array
title: List of error details. Typically there is only one element
items:
type: object
properties:
message:
type: string
title: Human readable error message
error_code:
type: string
enum:
- project_does_not_exist
- service_does_not_exist
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'project_does_not_exist: Project does not exist. service_does_not_exist: Service does not exist'
security:
- tokenAuth: []
oauth2:
- services:read
components:
schemas:
ServiceOpenSearchSecurityResetRequestBody:
type: object
description: ServiceOpenSearchSecurityResetRequestBody
properties:
admin_password:
type: string
minLength: 8
maxLength: 256
description: Current os-sec-admin password
new_password:
type: string
minLength: 8
maxLength: 256
description: New os-sec-admin password
required:
- admin_password
- new_password
ServiceOpensearchTieredStorageSummaryResponse:
type: object
description: ServiceOpensearchTieredStorageSummaryResponse
properties:
current_cost:
type: string
description: The current cost in USD of tiered storage since the beginning of the billing period
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
forecasted_cost:
type: string
description: The forecasted cost in USD of tiered storage in the billing period
forecasted_rate:
type: string
description: The rate on GBs/hour used to calculate the forecasted cost
message:
type: string
description: Printable result of the request
storage_usage_history:
type: object
description: History of usage and cumulative costs in the billing period
properties:
hourly:
type: array
description: History by hour
items:
type: object
properties:
estimated_cost:
type: string
description: The estimated cost in USD of tiered storage for this hour
hour_start:
type: string
maxLength: 36
description: Timestamp in ISO 8601 format, always in UTC
peak_stored_bytes:
type: integer
minimum: 0
description: Peak bytes stored on object storage at this hour
required:
- hour_start
- peak_stored_bytes
required:
- hourly
total_storage_usage:
type: integer
minimum: 0
description: Total storage usage by tiered storage, in bytes
required:
- current_cost
- forecasted_cost
- storage_usage_history
- total_storage_usage
ServiceOpenSearchAclUpdateResponse:
type: object
description: ServiceOpenSearchAclUpdateResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
opensearch_acl_config:
type: object
description: OpenSearch ACL configuration
properties:
acls:
type: array
maxItems: 512
description: List of OpenSearch ACLs
items:
type: object
properties:
rules:
type: array
maxItems: 256
description: OpenSearch rules
items:
type: object
properties:
index:
type: string
minLength: 1
maxLength: 249
description: OpenSearch index pattern
permission:
type: string
description: OpenSearch permission
enum:
- deny
- admin
- read
- readwrite
- write
required:
- index
- permission
username:
type: string
minLength: 1
maxLength: 64
description: Username
required:
- rules
- username
enabled:
type: boolean
description: Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.
required:
- acls
- enabled
required:
- opensearch_acl_config
ServiceOpensearchCustomRepoRestoreSnapshotResponse:
type: object
description: ServiceOpensearchCustomRepoRestoreSnapshotResponse
properties:
accepted:
type: boolean
description: Snapshot creation accepted
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
required:
- accepted
ServiceOpensearchListRestorationsInProgressResponse:
type: object
description: ServiceOpensearchListRestorationsInProgressResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
snapshots:
type: array
description: List of running restorations
items:
type: object
properties:
repo_name:
type: string
description: Repository name
running_time_in_nanos:
type: integer
description: Running time in nanoseconds
snapshot_name:
type: string
description: Snapshot name
start_time_in_millis:
type: integer
description: Restoration start time in milliseconds
required:
- snapshot_name
ServiceOpenSearchIndexListResponse:
type: object
description: ServiceOpenSearchIndexListResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
indexes:
type: array
description: List of OpenSearch indexes
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: Timestamp in ISO 8601 format, always in UTC
docs:
type: integer
description: Number of documents in index. -1 means not available.
health:
type: string
description: Index health
enum:
- green
- yellow
- red
- red*
- unknown
index_name:
type: string
description: Index name
number_of_replicas:
type: integer
minimum: 0
description: Number of replicas for an index
number_of_shards:
type: integer
minimum: 1
description: Number of shards in an index
read_only_allow_delete:
type: boolean
description: Whether an index is set as read-only (but allows deletion). null means unknown.
replication:
type: object
description: Index replication
properties:
leader_index:
type: string
description: Leader index name
leader_project:
type: string
description: Leader project name
leader_service:
type: string
description: Leader service name
size:
type: integer
description: Index size in bytes. -1 means not available.
status:
type: string
description: Index status
enum:
- unknown
- open
- close
- none
required:
- create_time
- index_name
- number_of_replicas
- number_of_shards
message:
type: string
description: Printable result of the request
required:
- indexes
ServiceOpenSearchSecuritySetResponse:
type: object
description: ServiceOpenSearchSecuritySetResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
security_plugin_admin_enabled:
type: boolean
description: security plugin admin defined
security_plugin_available:
type: boolean
description: Opensearch security available for the service
security_plugin_enabled:
type: boolean
description: Opensearch security enabled for the service
required:
- security_plugin_admin_enabled
- security_plugin_available
ServiceOpensearchCustomRepoShowSnapshotResponse:
type: object
description: ServiceOpensearchCustomRepoShowSnapshotResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
snapshots:
type: array
description: List of running snapshots
items:
type: object
properties:
snapshot:
type: string
description: Snapshot name
required:
- snapshot
required:
- snapshots
ServiceOpensearchCustomRepoRestoreSnapshotRequestBody:
type: object
description: ServiceOpensearchCustomRepoRestoreSnapshotRequestBody
properties:
ignore_index_settings:
type: string
maxLength: 4096
description: Comma-delimited list of index settings to ignore
ignore_unavailable:
type: boolean
description: Ignore indices that are missing or closed
include_aliases:
type: boolean
description: Include aliases
include_global_state:
type: boolean
description: Restore global state
index_settings:
type: string
maxLength: 4096
description: Comma-delimited list of index settings to override.
indices:
type: string
maxLength: 4096
description: Comma-separated list of index patterns to restore
partial:
type: boolean
description: Allows to restore snapshot of indices with unavailable shards
rename_alias_pattern:
type: string
maxLength: 4096
description: Rename pattern for aliases
rename_alias_replacement:
type: string
maxLength: 4096
description: Rename replacement for aliases
rename_pattern:
type: string
maxLength: 4096
description: Rename pattern for indices
rename_replacement:
type: string
maxLength: 4096
description: Rename replacement for indices
required:
- indices
ServiceOpenSearchAclSetResponse:
type: object
description: ServiceOpenSearchAclSetResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
opensearch_acl_config:
type: object
description: OpenSearch ACL configuration
properties:
acls:
type: array
maxItems: 512
description: List of OpenSearch ACLs
items:
type: object
properties:
rules:
type: array
maxItems: 256
description: OpenSearch rules
items:
type: object
properties:
index:
type: string
minLength: 1
maxLength: 249
description: OpenSearch index pattern
permission:
type: string
description: OpenSearch permission
enum:
- deny
- admin
- read
- readwrite
- write
required:
- index
- permission
username:
type: string
minLength: 1
maxLength: 64
description: Username
required:
- rules
- username
enabled:
type: boolean
description: Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.
required:
- acls
- enabled
required:
- opensearch_acl_config
ServiceOpenSearchSecurityGetResponse:
type: object
description: ServiceOpenSearchSecurityGetResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
security_plugin_admin_enabled:
type: boolean
description: security plugin admin defined
security_plugin_available:
type: boolean
description: Opensearch security available for the service
security_plugin_enabled:
type: boolean
description: Opensearch security enabled for the service
required:
- security_plugin_admin_enabled
- security_plugin_available
ServiceOpenSearchSecurityResetResponse:
type: object
description: ServiceOpenSearchSecurityResetResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
security_plugin_admin_enabled:
type: boolean
description: security plugin admin defined
security_plugin_available:
type: boolean
description: Opensearch security available for the service
security_plugin_enabled:
type: boolean
description: Opensearch security enabled for the service
required:
- security_plugin_admin_enabled
- security_plugin_available
ServiceOpensearchCustomRepoSnapshotsInProgressResponse:
type: object
description: ServiceOpensearchCustomRepoSnapshotsInProgressResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
snapshots:
type: array
description: List of running snapshots
items:
type: object
properties:
snapshot:
type: string
description: Snapshot name
required:
- snapshot
required:
- snapshots
ServiceOpensearchCustomRepoNameVerifyResponse:
type: object
description: ServiceOpensearchCustomRepoNameVerifyResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
nodes:
type: object
description: Nodes connected to the snapshot repository
properties: {}
ServiceOpenSearchSecuritySetRequestBody:
type: object
description: ServiceOpenSearchSecuritySetRequestBody
properties:
admin_password:
type: string
minLength: 8
maxLength: 256
description: os-sec-admin password
required:
- admin_password
ServiceOpenSearchIndexCloseMultipleResponse:
type: object
description: ServiceOpenSearchIndexCloseMultipleResponse
properties:
closed_indices:
type: array
maxItems: 10000
description: Successfully closed indices
items:
type: string
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
required:
- closed_indices
ServiceOpenSearchIndexOpenMultipleRequestBody:
type: object
description: ServiceOpenSearchIndexOpenMultipleRequestBody
properties:
indices:
type: array
maxItems: 10000
description: Indices list to open
items:
type: string
required:
- indices
ServiceOpensearchCustomRepoShowSnapshotStatusResponse:
type: object
description: ServiceOpensearchCustomRepoShowSnapshotStatusResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
snapshots:
type: array
description: List of running snapshots
items:
type: object
properties:
snapshot:
type: string
description: Snapshot name
required:
- snapshot
required:
- snapshots
ServiceOpenSearchIndexCloseResponse:
type: object
description: ServiceOpenSearchIndexCloseResponse
properties:
acknowledged:
type: boolean
description: Closing index acknowledged
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
required:
- acknowledged
ServiceOpensearchCustomRepoCreateSnapshotResponse:
type: object
description: ServiceOpensearchCustomRepoCreateSnapshotResponse
properties:
accepted:
type: boolean
description: Snapshot creation accepted
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
required:
- accepted
ServiceOpenSearchIndexOpenResponse:
type: object
description: ServiceOpenSearchIndexOpenResponse
properties:
acknowledged:
type: boolean
description: Opening index acknowledged
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
required:
- acknowledged
ServiceOpenSearchAclUpdateRequestBody:
type: object
description: ServiceOpenSearchAclUpdateRequestBody
properties:
opensearch_acl_config:
type: object
description: OpenSearch ACL configuration
properties:
acls:
type: array
maxItems: 512
description: List of OpenSearch ACLs
items:
type: object
properties:
rules:
type: array
maxItems: 256
description: OpenSearch rules
items:
type: object
properties:
index:
type: string
minLength: 1
maxLength: 249
description: OpenSearch index pattern
permission:
type: string
description: OpenSearch permission
enum:
- deny
- admin
- read
- readwrite
- write
required:
- index
- permission
username:
type: string
minLength: 1
maxLength: 64
description: Username
required:
- rules
- username
enabled:
type: boolean
description: Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.
default: false
required:
- opensearch_acl_config
ServiceOpenSearchIndexCloseMultipleRequestBody:
type: object
description: ServiceOpenSearchIndexCloseMultipleRequestBody
properties:
indices:
type: array
maxItems: 10000
description: Indices list to close
items:
type: string
required:
- indices
ServiceOpenSearchIndexDeleteResponse:
type: object
description: ServiceOpenSearchIndexDeleteResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
ServiceOpensearchCustomRepoDeleteSnapshotResponse:
type: object
description: ServiceOpensearchCustomRepoDeleteSnapshotResponse
properties:
acknowledged:
type: boolean
description: Snapshot deletion acknowledged
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
required:
- acknowledged
ServiceOpensearchCustomRepoListSnapshotsResponse:
type: object
description: ServiceOpensearchCustomRepoListSnapshotsResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
snapshots:
type: array
description: List of running snapshots
items:
type: object
properties:
snapshot:
type: string
description: Snapshot name
required:
- snapshot
required:
- snapshots
ServiceOpensearchListCustomReposResponse:
type: object
description: ServiceOpensearchListCustomReposResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
repositories:
type: array
description: List of custom repositories
items:
type: object
properties:
name:
type: string
description: Repository name
settings:
type: object
description: Repository settings
properties:
base_path:
type: string
description: Base path
required:
- base_path
type:
type: string
description: Repository type
required:
- name
- settings
- type
required:
- repositories
ServiceOpensearchCustomRepoCreateSnapshotRequestBody:
type: object
description: ServiceOpensearchCustomRepoCreateSnapshotRequestBody
properties:
ignore_unavailable:
type: boolean
description: Ignore indices that do not exist
default: false
include_global_state:
type: boolean
description: Include global state
default: true
indices:
type: string
maxLength: 4096
description: Comma separated list of index patterns to snapshot
partial:
type: boolean
description: Allow partial snapshots
default: false
ServiceOpenSearchAclGetResponse:
type: object
description: ServiceOpenSearchAclGetResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
opensearch_acl_config:
type: object
description: OpenSearch ACL configuration
properties:
acls:
type: array
maxItems: 512
description: List of OpenSearch ACLs
items:
type: object
properties:
rules:
type: array
maxItems: 256
description: OpenSearch rules
items:
type: object
properties:
index:
type: string
minLength: 1
maxLength: 249
description: OpenSearch index pattern
permission:
type: string
description: OpenSearch permission
enum:
- deny
- admin
- read
- readwrite
- write
required:
- index
- permission
username:
type: string
minLength: 1
maxLength: 64
description: Username
required:
- rules
- username
enabled:
type: boolean
description: Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.
required:
- acls
- enabled
required:
- opensearch_acl_config
ServiceOpensearchCustomRepoRestoreSnapshotCheckRequestBody:
type: object
description: ServiceOpensearchCustomRepoRestoreSnapshotCheckRequestBody
properties:
ignore_unavailable:
type: boolean
description: Ignore indices that are missing or closed
include_aliases:
type: boolean
description: Include aliases
indices:
type: string
maxLength: 4096
description: Comma-separated list of index patterns to check
rename_pattern:
type: string
maxLength: 4096
description: Rename pattern for indices
rename_replacement:
type: string
maxLength: 4096
description: Rename replacement for indices
required:
- indices
ServiceOpensearchCustomRepoRestoreSnapshotCheckResponse:
type: object
description: ServiceOpensearchCustomRepoRestoreSnapshotCheckResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
indices_to_close:
type: array
description: List of indices to close before restoration
items:
type: string
matched_indices:
type: array
description: List of matched indices for closing
items:
type: string
message:
type: string
description: Printable result of the request
target_indices:
type: array
description: List of target indices for restoration
items:
type: string
required:
- indices_to_close
- matched_indices
- target_indices
ServiceOpenSearchAclSetRequestBody:
type: object
description: ServiceOpenSearchAclSetRequestBody
properties:
opensearch_acl_config:
type: object
description: OpenSearch ACL configuration
properties:
acls:
type: array
maxItems: 512
description: List of OpenSearch ACLs
items:
type: object
properties:
rules:
type: array
maxItems: 256
description: OpenSearch rules
items:
type: object
properties:
index:
type: string
minLength: 1
maxLength: 249
description: OpenSearch index pattern
permission:
type: string
description: OpenSearch permission
enum:
- deny
- admin
- read
- readwrite
- write
required:
- index
- permission
username:
type: string
minLength: 1
maxLength: 64
description: Username
required:
- rules
- username
enabled:
type: boolean
description: Enable OpenSearch ACLs. When disabled authenticated service users have unrestricted access.
default: false
required:
- acls
- enabled
required:
- opensearch_acl_config
ServiceOpenSearchIndexOpenMultipleResponse:
type: object
description: ServiceOpenSearchIndexOpenMultipleResponse
properties:
errors:
type: array
description: List of errors occurred during request processing
items:
type: object
properties:
message:
type: string
description: Printable error message
more_info:
type: string
description: URL to the documentation of the error
status:
type: integer
description: HTTP error status code
required:
- message
- status
message:
type: string
description: Printable result of the request
opened_indices:
type: array
maxItems: 10000
description: Successfully opened indices
items:
type: string
required:
- opened_indices
parameters:
service_name:
in: path
name: service_name
description: Service name
schema:
type: string
required: true
snapshot_name:
in: path
name: snapshot_name
description: Snapshot name
schema:
type: string
required: true
index_pattern:
in: path
name: index_pattern
description: OpenSearch index name, comma-separated list or pattern
schema:
type: string
required: true
project:
in: path
name: project
description: Project name
schema:
type: string
required: true
repository_name:
in: path
name: repository_name
description: Repository name
schema:
type: string
required: true
securitySchemes:
tokenAuth:
description: 'Header should be of the format `authorization: aivenv1 `. Tokens can be obtained from [your Aiven profile page](https://console.aiven.io/profile/auth)'
scheme: bearer
type: http
oauth2:
type: oauth2
description: OAuth2 security scheme
flows:
authorizationCode:
authorizationUrl: https://console.aiven.io/oauth/authorize
tokenUrl: https://api.aiven.io/v1/oauth2/token
scopes:
all: Provide full access to the API
accounts: Allow enumerating and reading accounts configuration
accounts:read: Allow modifying account configuration
accounts:write: Provides full access to authentication related API
authentication: Provides full access to authentication related API
authentication:read: Allow reading authentication related configuration on resources (user profile, accounts)
authentication:write: Allow modifying authentication related configurations on resources (user profile, accounts)
billing: Provide full access to billing APIs
billing:read: Allow reading billing information and configuration
billing:write: Allow writing billing configuration
payments: Provide full access to payment method APIs
payments:read: Allow reading the payment method configurations
payments:write: Allows writing payment method configuration
privatelink: Provide full access to private link APIs
privatelink:read: Allow enumerating and reading private link items and configurations
privatelink:write: Allow writing (creating, modifying, deleting) private link items
projects: Provide full access to projects APIs
projects:read: Allow enumerating projects and reading their configuration
projects:write: Allow writing (creating, modifying, deleting) projects
scim: Provide full access to SCIM operations
scim:read: Allow reading SCIM endpoints
scim:write: Allow writing (modifying) SCIM endpoints
services: Provide full access to services APIs
services:read: Allow enumerating services and reading their configuration
services:write: Allow writing (creating, modifying, deleting) services
static_ips: Provide full access to static IPs APIs
static_ips:read: Allow enumerating and reading static IP items and configurations
static_ips:write: Allow writing (creating, modifying, deleting) static IP items
tickets: Provide full access to support ticket APIs
tickets:read: Allow enumerating and reading support tickets
tickets:write: Allow writing (creating, modifying) support tickets
user: Provide full access to user profile APIs
user:read: Allow reading user profile and configuration
user:write: Allow writing (modifying) user profile and configuration
externalDocs:
description: Aiven CLI client
url: https://github.com/aiven/aiven-client