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