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 Project 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: Project
x-displayName: Project
paths:
/project/{project}/vpc-peering-connection-types:
get:
summary: List VPC peering connection types for a project
tags:
- Project
operationId: ListProjectVpcPeeringConnectionTypes
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListProjectVpcPeeringConnectionTypesResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/alerts:
get:
summary: List active alerts for a project
tags:
- Project
operationId: ProjectAlertsList
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectAlertsListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project:
post:
summary: Create a project
tags:
- Project
operationId: ProjectCreate
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectCreateRequestBody'
example:
account_id: a22ba494e096
add_account_owners_admin_access: true
address_lines:
- Main Street 1
base_port: 10000
billing_address: 'DEPRECATED: use split address fields like `company`, `address_lines`, `zip_code`, `city` and `state` instead'
billing_currency: USD
billing_emails:
- email: jane@example.com
billing_extra_text: 'Purchase order: PO100018'
billing_group_id: ffb3f0cd-5532-4eb9-8867-f2cac5823492
card_id: 9330c086-8781-11e5-89ff-5404a64abfef
city: Helsinki
cloud: aws-eu-central-1
company: My Company
copy_from_project: myexistingproject
copy_tags: true
country_code: FI
project: myproject
state: ''
tags: {}
tech_emails:
- email: jane@example.com
use_source_project_billing_group: false
vat_id: FI27957435
zip_code: '01234'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectCreateResponse'
'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:
- project_already_exists
title: Machine processable error code. Clients must be prepared to handle new codes.
description: 'project_already_exists: Project already exists'
security:
- tokenAuth: []
oauth2:
- projects:write
get:
summary: List projects
tags:
- Project
operationId: ProjectList
deprecated: true
description: 'DEPRECATED: Use the organization projects API to list projects within each organization
'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}:
delete:
summary: Delete project
tags:
- Project
operationId: ProjectDelete
deprecated: true
description: 'DEPRECATED: Use the per-organization project DELETE API
'
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectDeleteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
get:
summary: Get project details
tags:
- Project
operationId: ProjectGet
deprecated: true
description: 'DEPRECATED: Use the organization project API to retrieve project details
'
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectGetResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
put:
summary: Update project
tags:
- Project
operationId: ProjectUpdate
deprecated: true
description: 'DEPRECATED: Use the organization project PATCH API for partial updates
'
parameters:
- $ref: '#/components/parameters/project'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUpdateRequestBody'
example:
account_id: a22ba494e096
add_account_owners_admin_access: true
address_lines:
- Main Street 1
billing_address: 'DEPRECATED: use split address fields like `company`, `address_lines`, `zip_code`, `city` and `state` instead'
billing_currency: USD
billing_emails:
- email: jane@example.com
billing_extra_text: 'Purchase order: PO100018'
billing_group_id: ffb3f0cd-5532-4eb9-8867-f2cac5823492
card_id: 9330c086-8781-11e5-89ff-5404a64abfef
city: Helsinki
cloud: aws-eu-central-1
company: My Company
country_code: FI
project_name: myproject
state: ''
tags: {}
tech_emails:
- email: jane@example.com
vat_id: FI27957435
zip_code: '01234'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUpdateResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/download-sbom/{file_format}/{download_cookie}:
get:
summary: Download SBOM report
tags:
- Project
operationId: ProjectDownloadSBOMReport
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/file_format'
- $ref: '#/components/parameters/download_cookie'
responses:
'200':
description: Returns a SBOM report
content:
text/csv:
schema:
type: string
format: binary
text/json:
schema:
type: string
format: binary
/project/{project}/generate-sbom-download-url/{file_format}:
get:
summary: Generate SBOM for project
tags:
- Project
operationId: ProjectGenerateSbomDownloadUrl
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/file_format'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectGenerateSbomDownloadUrlResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/events:
get:
summary: Get project event log entries
tags:
- Project
operationId: ProjectGetEventLogs
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectGetEventLogsResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/invite:
post:
summary: Send project membership invitation
tags:
- Project
operationId: ProjectInvite
deprecated: true
description: 'DEPRECATED: Use the Organizations APIs to invite users and the Permissions API to manage access
'
parameters:
- $ref: '#/components/parameters/project'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectInviteRequestBody'
example:
member_type: admin
user_email: jane@example.com
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectInviteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/invite/{invite_verification_code}:
post:
summary: Confirm project invite
tags:
- Project
operationId: ProjectInviteAccept
deprecated: true
description: 'DEPRECATED: Use the Organizations APIs to invite users and the Permissions API to manage access
'
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/invite_verification_code'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectInviteAcceptResponse'
/project/{project}/invite/{invited_email}:
delete:
summary: Delete an invitation to a project
tags:
- Project
operationId: ProjectInviteDelete
deprecated: true
description: 'DEPRECATED: Use the Organizations APIs to invite users and the Permissions API to manage access
'
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/invited_email'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectInviteDeleteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/privatelink-availability:
get:
summary: List Privatelink cloud availability and prices for a project
tags:
- Project
operationId: ProjectPrivatelinkAvailabilityList
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectPrivatelinkAvailabilityListResponse'
security:
- tokenAuth: []
oauth2:
- privatelink:read
/project/{project}/service-types/{service_type}/plans:
get:
summary: List service plans
tags:
- Project
operationId: ProjectServicePlanList
description: Returns a list of the plans available for a service type.
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_type'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectServicePlanListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/pricing/service-types/{service_type}/plans/{service_plan}/clouds/{cloud}:
get:
summary: Get plan pricing
tags:
- Project
operationId: ProjectServicePlanPriceGet
description: Returns pricing information for a service plan.
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_type'
- $ref: '#/components/parameters/service_plan'
- $ref: '#/components/parameters/cloud'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectServicePlanPriceGetResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/service-types/{service_type}/plans/{service_plan}:
get:
summary: Get service plan details
tags:
- Project
operationId: ProjectServicePlanSpecsGet
description: Returns information about a plan for a service type such as the disk storage and backup configuration.
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_type'
- $ref: '#/components/parameters/service_plan'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectServicePlanSpecsGetResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/service-types/{service_type}:
get:
summary: Get service type details
tags:
- Project
operationId: ProjectServiceTypesGet
description: Returns the configuration options for a service type.
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/service_type'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectServiceTypesGetResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/service-types:
get:
summary: List service types
tags:
- Project
operationId: ProjectServiceTypesList
description: Returns a list of all available service types and their configuration options.
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectServiceTypesListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/tags:
get:
summary: List all tags attached to this project
tags:
- Project
operationId: ProjectTagsList
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectTagsListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
put:
summary: Replace all project tags with a new set of tags, deleting old ones
tags:
- Project
operationId: ProjectTagsReplace
parameters:
- $ref: '#/components/parameters/project'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectTagsReplaceRequestBody'
example:
tags: {}
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectTagsReplaceResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
patch:
summary: Update one or more tags, creating ones that don't exist, and deleting ones given NULL value
tags:
- Project
operationId: ProjectTagsUpdate
parameters:
- $ref: '#/components/parameters/project'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectTagsUpdateRequestBody'
example:
tags: {}
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectTagsUpdateResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/users:
get:
summary: List users with access to the project. May contain same user multiple times if they belong to multiple teams associated to the project
tags:
- Project
operationId: ProjectUserList
deprecated: true
description: 'DEPRECATED: Use the Organizations APIs to manage users and the Permissions API to manage access
'
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUserListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/user/{user_email}:
delete:
summary: Remove user from the project
tags:
- Project
operationId: ProjectUserRemove
deprecated: true
description: 'DEPRECATED: Use the Organizations APIs to update users and the Permissions API to manage access
'
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/user_email'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUserRemoveResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
put:
summary: Update a project user
tags:
- Project
operationId: ProjectUserUpdate
deprecated: true
description: 'DEPRECATED: Use the Organizations APIs to update users and the Permissions API to manage access
'
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/user_email'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUserUpdateRequestBody'
example:
member_type: admin
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectUserUpdateResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/vpcs:
post:
summary: Create a VPC in a cloud for the project
tags:
- Project
operationId: VpcCreate
parameters:
- $ref: '#/components/parameters/project'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/VpcCreateRequestBody'
example:
cloud_name: aws-eu-central-1
network_cidr: 192.168.6.0/24
peering_connections:
- peer_azure_app_id: adcf7194-d877-4505-a47a-91fefd96e3b8
peer_azure_tenant_id: adcf7194-d877-4505-a47a-91fefd96e3b8
peer_cloud_account: '123456789012'
peer_region: us-east-1
peer_resource_group: my-peered-rg
peer_vpc: vpc-2f09a348
user_peer_network_cidrs:
- 192.168.6.0/24
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcCreateResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
get:
summary: List VPCs for a project
tags:
- Project
operationId: VpcList
parameters:
- $ref: '#/components/parameters/project'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcListResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/vpcs/{project_vpc_id}:
delete:
summary: Delete a project VPC
tags:
- Project
operationId: VpcDelete
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcDeleteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
get:
summary: Get VPC information
tags:
- Project
operationId: VpcGet
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcGetResponse'
security:
- tokenAuth: []
oauth2:
- projects:read
/project/{project}/vpcs/{project_vpc_id}/peering-connections:
post:
summary: Create a peering connection for a project VPC
tags:
- Project
operationId: VpcPeeringConnectionCreate
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionCreateRequestBody'
example:
peer_azure_app_id: adcf7194-d877-4505-a47a-91fefd96e3b8
peer_azure_tenant_id: adcf7194-d877-4505-a47a-91fefd96e3b8
peer_cloud_account: '123456789012'
peer_region: us-east-1
peer_resource_group: my-peered-rg
peer_vpc: vpc-2f09a348
user_peer_network_cidrs:
- 192.168.6.0/24
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionCreateResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/vpcs/{project_vpc_id}/peering-connections/peer-accounts/{peer_cloud_account}/peer-vpcs/{peer_vpc}:
delete:
summary: Delete a peering connection for a project VPC
tags:
- Project
operationId: VpcPeeringConnectionDelete
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
- $ref: '#/components/parameters/peer_cloud_account'
- $ref: '#/components/parameters/peer_vpc'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionDeleteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/vpcs/{project_vpc_id}/user-peer-network-cidrs:
put:
summary: Update user-defined peer network CIDRs for a project VPC
tags:
- Project
operationId: VpcPeeringConnectionUpdate
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionUpdateRequestBody'
example:
add:
- cidr: 192.168.6.0/24
peer_cloud_account: '123456789012'
peer_resource_group: my-peered-rg
peer_vpc: vpc-2f09a348
delete:
- 192.168.6.0/24
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionUpdateResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
? /project/{project}/vpcs/{project_vpc_id}/peering-connections/peer-accounts/{peer_cloud_account}/peer-vpcs/{peer_vpc}/peer-regions/{peer_region}
: delete:
summary: Delete a peering connection for a project VPC
tags:
- Project
operationId: VpcPeeringConnectionWithRegionDelete
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
- $ref: '#/components/parameters/peer_cloud_account'
- $ref: '#/components/parameters/peer_vpc'
- $ref: '#/components/parameters/peer_region'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionWithRegionDeleteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
? /project/{project}/vpcs/{project_vpc_id}/peering-connections/peer-accounts/{peer_cloud_account}/peer-resource-groups/{peer_resource_group}/peer-vpcs/{peer_vpc}
: delete:
summary: Delete a peering connection for a project VPC
tags:
- Project
operationId: VpcPeeringConnectionWithResourceGroupDelete
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
- $ref: '#/components/parameters/peer_cloud_account'
- $ref: '#/components/parameters/peer_resource_group'
- $ref: '#/components/parameters/peer_vpc'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionWithResourceGroupDeleteResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
/project/{project}/vpcs/{project_vpc_id}/peering-connections/refresh:
post:
summary: Check if the state of peering connections in the cloud has changed
tags:
- Project
operationId: VpcPeeringConnectionsRefresh
description: 'This endpoint may be changed or removed at any time. Don''t use it in production environments.
Triggers an asynchronous refresh of the peering connection states for a project VPC. Checks the state of the peering connections in the cloud provider and updates them in Aiven. To confirm the refresh has completed, retrieve the project VPC using GET /project/{project}/vpcs/{project_vpc_id} and check that the pending_build_only_peering_connections field has returned to null.
'
x-badges:
- name: Experimental
position: after
color: '#787885'
x-experimental: true
parameters:
- $ref: '#/components/parameters/project'
- $ref: '#/components/parameters/project_vpc_id'
responses:
'200':
description: Response
content:
application/json:
schema:
$ref: '#/components/schemas/VpcPeeringConnectionsRefreshResponse'
security:
- tokenAuth: []
oauth2:
- projects:write
components:
schemas:
VpcPeeringConnectionUpdateResponse:
type: object
description: VpcPeeringConnectionUpdateResponse
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
create_time:
type: string
maxLength: 36
description: VPC creation timestamp
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
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peering_connections:
type: array
description: List of peering connections
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
pending_build_only_peering_connections:
type: string
maxLength: 36
description: VPC rebuild is scheduled
project_vpc_id:
type: string
minLength: 36
maxLength: 36
description: Project VPC ID
state:
type: string
description: Project VPC state
enum:
- ACTIVE
- APPROVED
- DELETED
- DELETING
update_time:
type: string
maxLength: 36
description: Timestamp of last change to VPC
required:
- cloud_name
- create_time
- network_cidr
- peering_connections
- project_vpc_id
- state
- update_time
VpcGetResponse:
type: object
description: VpcGetResponse
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
create_time:
type: string
maxLength: 36
description: VPC creation timestamp
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
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peering_connections:
type: array
description: List of peering connections
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
pending_build_only_peering_connections:
type: string
maxLength: 36
description: VPC rebuild is scheduled
project_vpc_id:
type: string
minLength: 36
maxLength: 36
description: Project VPC ID
state:
type: string
description: Project VPC state
enum:
- ACTIVE
- APPROVED
- DELETED
- DELETING
update_time:
type: string
maxLength: 36
description: Timestamp of last change to VPC
required:
- cloud_name
- create_time
- network_cidr
- peering_connections
- project_vpc_id
- state
- update_time
ProjectTagsReplaceResponse:
type: object
description: ProjectTagsReplaceResponse
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
ProjectCreateRequestBody:
type: object
description: ProjectCreateRequestBody
properties:
account_id:
type: string
maxLength: 36
description: Account ID
add_account_owners_admin_access:
type: boolean
description: '[DEPRECATED] If account_id is set, grant account owner team admin access to the new project. This flag is ignored, and assumed true.'
address_lines:
type: array
maxItems: 3
description: '[DEPRECATED] Address lines'
items:
type: string
base_port:
type: integer
minimum: 10000
maximum: 29000
description: New services in this project will use this value as a base when deriving their service port numbers. This allows new services to allocate predictable and specific service ports. If not provided during project creation a random base port is used.
title: Base value that new services in this project will use to derive their port numbers.
billing_address:
type: string
maxLength: 1000
description: 'DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead'
billing_currency:
type: string
description: '[DEPRECATED] Billing currency'
enum:
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- JPY
- NOK
- NZD
- SEK
- SGD
- USD
billing_emails:
type: array
maxItems: 10
description: '[DEPRECATED] Billing emails'
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
billing_extra_text:
type: string
maxLength: 1000
description: '[DEPRECATED] Extra text to be included in all project invoices'
billing_group_id:
type: string
minLength: 36
maxLength: 36
description: Billing group ID
card_id:
type: string
maxLength: 64
description: '[DEPRECATED] Credit card ID'
city:
type: string
maxLength: 50
description: '[DEPRECATED] Address city'
cloud:
type: string
maxLength: 256
description: Target cloud
company:
type: string
maxLength: 83
description: '[DEPRECATED] Name of company'
copy_from_project:
type: string
maxLength: 63
description: Project name from which to copy settings to the new project
copy_tags:
type: boolean
description: Copy tags from the source project. If request contains additional tags, the tags copied from source are updated with them.
default: false
country_code:
type: string
maxLength: 2
description: '[DEPRECATED] Two letter country code for billing country'
project:
type: string
maxLength: 63
description: Project name
state:
type: string
maxLength: 30
description: '[DEPRECATED] Address state'
tags:
type: object
description: Set of resource tags
properties: {}
tech_emails:
type: array
maxItems: 10
description: List of project tech email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
use_source_project_billing_group:
type: boolean
description: If set to true, use the same billing group that is used in source project. If set to false, create a copy of the billing group used in the source project with the same information. If new project is not being copied from existing one this option has no effect
title: Use the same billing group that is used in source project.
default: false
vat_id:
type: string
maxLength: 64
description: '[DEPRECATED] EU VAT identification'
zip_code:
type: string
maxLength: 36
description: '[DEPRECATED] Address zip code'
required:
- project
ProjectTagsUpdateResponse:
type: object
description: ProjectTagsUpdateResponse
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
ProjectListResponse:
type: object
description: ProjectListResponse
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
project_membership:
type: object
description: Project membership and type of membership
properties:
ANY:
type: string
description: Project member type
enum:
- admin
- developer
- operator
- organization:app_users:write
- organization:audit_logs:read
- organization:billing:read
- organization:billing:write
- organization:domains:write
- organization:groups:write
- organization:networking:read
- organization:networking:write
- organization:projects:write
- organization:users:write
- project:audit_logs:read
- project:integrations:read
- project:integrations:write
- project:networking:read
- project:networking:write
- project:permissions:read
- project:services:read
- project:services:write
- read_only
- role:organization:admin
- role:project:admin
- role:services:maintenance
- role:services:recover
- service:configuration:write
- service:data:write
- service:logs:read
- service:metrics:read
- service:secrets:read
- service:users:write
project_memberships:
type: object
description: List of project membership and type of membership
properties:
ANY:
type: array
description: List of project member type
items:
type: string
projects:
type: array
description: List of projects
items:
type: object
properties:
account_id:
type: string
maxLength: 36
description: Account ID
account_name:
type: string
maxLength: 83
description: Account name
address_lines:
type: array
maxItems: 3
description: Address lines
items:
type: string
available_credits:
type: string
description: 'DEPRECATED: Available credits, in USD. Always 0.00, use billing group credits instead'
billing_address:
type: string
maxLength: 1000
description: 'DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead'
billing_currency:
type: string
description: Billing currency
enum:
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- JPY
- NOK
- NZD
- SEK
- SGD
- USD
billing_emails:
type: array
maxItems: 10
description: List of project billing email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
billing_extra_text:
type: string
maxLength: 1000
description: Extra text to be included in all project invoices, e.g. purchase order or cost center number
billing_group_id:
type: string
minLength: 36
maxLength: 36
description: Billing group ID
billing_group_name:
type: string
maxLength: 128
description: Billing group name
card_info:
type: object
description: Credit card assigned to the project
properties:
brand:
type: string
description: Brand
card_id:
type: string
maxLength: 64
description: Credit card ID
country:
type: string
maxLength: 128
description: Country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
exp_month:
type: integer
minimum: 1
maximum: 12
description: Expiration month
exp_year:
type: integer
minimum: 2015
maximum: 2100
description: Expiration year
last4:
type: string
description: Credit card last four digits
name:
type: string
maxLength: 256
description: Name on the credit card
user_email:
type: string
maxLength: 254
description: User email address
required:
- brand
- card_id
- country
- country_code
- exp_month
- exp_year
- last4
- name
- user_email
city:
type: string
maxLength: 50
description: Address city
company:
type: string
maxLength: 83
description: Name of a company
country:
type: string
maxLength: 128
description: Billing country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
default_cloud:
type: string
maxLength: 256
description: Default cloud to use when launching services
end_of_life_extension:
type: object
description: End of life extension information
properties:
elasticsearch:
type: object
description: Service EOL extension
properties:
eol_date:
type: string
description: Extended EOL date
version:
type: string
description: Service version
required:
- eol_date
- version
estimated_balance:
type: string
description: Estimated balance, in USD
estimated_balance_local:
type: string
description: Estimated balance, in billing currency
features:
type: object
description: Feature flags
properties: {}
organization_id:
type: string
maxLength: 36
description: Organization ID
payment_method:
type: string
description: Payment method
project_name:
type: string
maxLength: 63
description: Project name
state:
type: string
maxLength: 30
description: Address state or province
tags:
type: object
description: Set of resource tags
properties: {}
tech_emails:
type: array
maxItems: 10
description: List of project tech email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
tenant_id:
type: string
description: Tenant ID
trial_expiration_time:
type: string
maxLength: 36
description: Trial expiration time (ISO 8601)
vat_id:
type: string
maxLength: 64
description: EU VAT Identification Number
zip_code:
type: string
maxLength: 36
description: Address zip code
required:
- account_id
- billing_address
- billing_emails
- billing_group_id
- billing_group_name
- country
- country_code
- default_cloud
- estimated_balance
- organization_id
- payment_method
- project_name
- vat_id
required:
- project_membership
- project_memberships
- projects
ProjectInviteRequestBody:
type: object
description: ProjectInviteRequestBody
properties:
member_type:
type: string
description: Project member type
default: developer
enum:
- admin
- developer
- operator
- organization:app_users:write
- organization:audit_logs:read
- organization:billing:read
- organization:billing:write
- organization:domains:write
- organization:groups:write
- organization:networking:read
- organization:networking:write
- organization:projects:write
- organization:users:write
- project:audit_logs:read
- project:integrations:read
- project:integrations:write
- project:networking:read
- project:networking:write
- project:permissions:read
- project:services:read
- project:services:write
- read_only
- role:organization:admin
- role:project:admin
- role:services:maintenance
- role:services:recover
- service:configuration:write
- service:data:write
- service:logs:read
- service:metrics:read
- service:secrets:read
- service:users:write
user_email:
type: string
maxLength: 254
description: User email address
required:
- user_email
VpcPeeringConnectionCreateRequestBody:
type: object
description: VpcPeeringConnectionCreateRequestBody
properties:
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region on AWS. May be omitted or set to null if the peer is in the same region as the Aiven project VPC. Omit or set to null on GCP, Azure, or UpCloud.
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
required:
- peer_cloud_account
- peer_vpc
ProjectUserUpdateResponse:
type: object
description: ProjectUserUpdateResponse
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
VpcPeeringConnectionWithResourceGroupDeleteResponse:
type: object
description: VpcPeeringConnectionWithResourceGroupDeleteResponse
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
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
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
ProjectGetResponse:
type: object
description: ProjectGetResponse
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
project:
type: object
description: Project information
properties:
account_id:
type: string
maxLength: 36
description: Account ID
account_name:
type: string
maxLength: 83
description: Account name
address_lines:
type: array
maxItems: 3
description: Address lines
items:
type: string
available_credits:
type: string
description: 'DEPRECATED: Available credits, in USD. Always 0.00, use billing group credits instead'
billing_address:
type: string
maxLength: 1000
description: 'DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead'
billing_currency:
type: string
description: Billing currency
enum:
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- JPY
- NOK
- NZD
- SEK
- SGD
- USD
billing_emails:
type: array
maxItems: 10
description: List of project billing email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
billing_extra_text:
type: string
maxLength: 1000
description: Extra text to be included in all project invoices, e.g. purchase order or cost center number
billing_group_id:
type: string
minLength: 36
maxLength: 36
description: Billing group ID
billing_group_name:
type: string
maxLength: 128
description: Billing group name
card_info:
type: object
description: Credit card assigned to the project
properties:
brand:
type: string
description: Brand
card_id:
type: string
maxLength: 64
description: Credit card ID
country:
type: string
maxLength: 128
description: Country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
exp_month:
type: integer
minimum: 1
maximum: 12
description: Expiration month
exp_year:
type: integer
minimum: 2015
maximum: 2100
description: Expiration year
last4:
type: string
description: Credit card last four digits
name:
type: string
maxLength: 256
description: Name on the credit card
user_email:
type: string
maxLength: 254
description: User email address
required:
- brand
- card_id
- country
- country_code
- exp_month
- exp_year
- last4
- name
- user_email
city:
type: string
maxLength: 50
description: Address city
company:
type: string
maxLength: 83
description: Name of a company
country:
type: string
maxLength: 128
description: Billing country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
default_cloud:
type: string
maxLength: 256
description: Default cloud to use when launching services
end_of_life_extension:
type: object
description: End of life extension information
properties:
elasticsearch:
type: object
description: Service EOL extension
properties:
eol_date:
type: string
description: Extended EOL date
version:
type: string
description: Service version
required:
- eol_date
- version
estimated_balance:
type: string
description: Estimated balance, in USD
estimated_balance_local:
type: string
description: Estimated balance, in billing currency
features:
type: object
description: Feature flags
properties: {}
organization_id:
type: string
maxLength: 36
description: Organization ID
payment_method:
type: string
description: Payment method
project_name:
type: string
maxLength: 63
description: Project name
state:
type: string
maxLength: 30
description: Address state or province
tags:
type: object
description: Set of resource tags
properties: {}
tech_emails:
type: array
maxItems: 10
description: List of project tech email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
tenant_id:
type: string
description: Tenant ID
trial_expiration_time:
type: string
maxLength: 36
description: Trial expiration time (ISO 8601)
vat_id:
type: string
maxLength: 64
description: EU VAT Identification Number
zip_code:
type: string
maxLength: 36
description: Address zip code
required:
- account_id
- billing_address
- billing_emails
- billing_group_id
- billing_group_name
- country
- country_code
- default_cloud
- estimated_balance
- organization_id
- payment_method
- project_name
- vat_id
required:
- project
ProjectAlertsListResponse:
type: object
description: ProjectAlertsListResponse
properties:
alerts:
type: array
description: List of active alerts for the service
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: Event creation timestamp (ISO 8601)
event:
type: string
description: Name of the alerting event
node_name:
type: string
description: Name of the service node
project_name:
type: string
maxLength: 63
description: Project name
service_name:
type: string
minLength: 1
maxLength: 64
description: Service name
service_type:
type: string
maxLength: 64
description: Service type code
severity:
type: string
description: Severity of the event
required:
- create_time
- event
- project_name
- severity
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:
- alerts
ProjectUserListResponse:
type: object
description: ProjectUserListResponse
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
group_users:
type: array
description: List of users in groups that have access to the project
items:
type: object
properties:
member_type:
type: string
description: Project member type
enum:
- admin
- developer
- operator
- organization:app_users:write
- organization:audit_logs:read
- organization:billing:read
- organization:billing:write
- organization:domains:write
- organization:groups:write
- organization:networking:read
- organization:networking:write
- organization:projects:write
- organization:users:write
- project:audit_logs:read
- project:integrations:read
- project:integrations:write
- project:networking:read
- project:networking:write
- project:permissions:read
- project:services:read
- project:services:write
- read_only
- role:organization:admin
- role:project:admin
- role:services:maintenance
- role:services:recover
- service:configuration:write
- service:data:write
- service:logs:read
- service:metrics:read
- service:secrets:read
- service:users:write
real_name:
type: string
maxLength: 256
description: User real name
user_email:
type: string
maxLength: 254
description: User email address
user_group_id:
type: string
description: User group ID
required:
- member_type
- real_name
- user_email
- user_group_id
invitations:
type: array
description: List of pending invitations
items:
type: object
properties:
invite_time:
type: string
maxLength: 36
description: Timestamp in ISO 8601 format, always in UTC
invited_user_email:
type: string
maxLength: 254
description: User email address
inviting_user_email:
type: string
maxLength: 254
description: User email address
member_type:
type: string
description: Project member type
enum:
- admin
- developer
- operator
- organization:app_users:write
- organization:audit_logs:read
- organization:billing:read
- organization:billing:write
- organization:domains:write
- organization:groups:write
- organization:networking:read
- organization:networking:write
- organization:projects:write
- organization:users:write
- project:audit_logs:read
- project:integrations:read
- project:integrations:write
- project:networking:read
- project:networking:write
- project:permissions:read
- project:services:read
- project:services:write
- read_only
- role:organization:admin
- role:project:admin
- role:services:maintenance
- role:services:recover
- service:configuration:write
- service:data:write
- service:logs:read
- service:metrics:read
- service:secrets:read
- service:users:write
required:
- invite_time
- invited_user_email
- inviting_user_email
- member_type
message:
type: string
description: Printable result of the request
users:
type: array
description: List of project's users
items:
type: object
properties:
auth:
type: array
description: List of user's required authentication methods
items:
type: string
billing_contact:
type: boolean
description: Set for project's billing contacts
create_time:
type: string
maxLength: 36
description: Timestamp in ISO 8601 format, always in UTC
member_type:
type: string
description: Project member type
enum:
- admin
- developer
- operator
- organization:app_users:write
- organization:audit_logs:read
- organization:billing:read
- organization:billing:write
- organization:domains:write
- organization:groups:write
- organization:networking:read
- organization:networking:write
- organization:projects:write
- organization:users:write
- project:audit_logs:read
- project:integrations:read
- project:integrations:write
- project:networking:read
- project:networking:write
- project:permissions:read
- project:services:read
- project:services:write
- read_only
- role:organization:admin
- role:project:admin
- role:services:maintenance
- role:services:recover
- service:configuration:write
- service:data:write
- service:logs:read
- service:metrics:read
- service:secrets:read
- service:users:write
real_name:
type: string
maxLength: 256
description: User real name
team_id:
type: string
maxLength: 32
description: Team ID
team_name:
type: string
maxLength: 128
description: Team name
user_email:
type: string
maxLength: 254
description: User email address
user_id:
type: string
description: User ID
required:
- auth
- billing_contact
- create_time
- member_type
- team_id
- team_name
- user_email
- user_id
required:
- group_users
- invitations
- users
ProjectGetEventLogsResponse:
type: object
description: ProjectGetEventLogsResponse
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
events:
type: array
description: List of project event log entries
items:
type: object
properties:
actor:
type: string
description: Initiator of the event
event_desc:
type: string
description: Event description
event_type:
type: string
description: Event type identifier
id:
type: string
maxLength: 40
description: Event identifier (unique across all projects)
service_name:
type: string
minLength: 1
maxLength: 64
description: Service name
time:
type: string
maxLength: 36
description: Timestamp in ISO 8601 format, always in UTC
required:
- actor
- event_desc
- event_type
- id
- service_name
- time
message:
type: string
description: Printable result of the request
required:
- events
VpcListResponse:
type: object
description: VpcListResponse
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
vpcs:
type: array
description: List of VPCs
items:
type: object
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
create_time:
type: string
maxLength: 36
description: VPC creation timestamp
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
project_vpc_id:
type: string
minLength: 36
maxLength: 36
description: Project VPC ID
state:
type: string
description: Project VPC state
enum:
- ACTIVE
- APPROVED
- DELETED
- DELETING
update_time:
type: string
maxLength: 36
description: Timestamp of last change to VPC
required:
- cloud_name
- create_time
- network_cidr
- project_vpc_id
- state
- update_time
required:
- vpcs
VpcDeleteResponse:
type: object
description: VpcDeleteResponse
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
create_time:
type: string
maxLength: 36
description: VPC creation timestamp
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
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peering_connections:
type: array
description: List of peering connections
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
pending_build_only_peering_connections:
type: string
maxLength: 36
description: VPC rebuild is scheduled
project_vpc_id:
type: string
minLength: 36
maxLength: 36
description: Project VPC ID
state:
type: string
description: Project VPC state
enum:
- ACTIVE
- APPROVED
- DELETED
- DELETING
update_time:
type: string
maxLength: 36
description: Timestamp of last change to VPC
required:
- cloud_name
- create_time
- network_cidr
- peering_connections
- project_vpc_id
- state
- update_time
VpcCreateRequestBody:
type: object
description: VpcCreateRequestBody
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peering_connections:
type: array
maxItems: 128
description: List of peering connection requests for the VPC
items:
type: object
properties:
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region on AWS. May be omitted or set to null if the peer is in the same region as the Aiven project VPC. Omit or set to null on GCP, Azure, or UpCloud.
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
required:
- peer_cloud_account
- peer_vpc
required:
- cloud_name
- network_cidr
- peering_connections
ProjectTagsReplaceRequestBody:
type: object
description: ProjectTagsReplaceRequestBody
properties:
tags:
type: object
description: Set of resource tags
properties: {}
required:
- tags
ProjectGenerateSbomDownloadUrlResponse:
type: object
description: ProjectGenerateSbomDownloadUrlResponse
properties:
download_url:
type: string
maxLength: 2048
description: Relative signed URL for report download
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:
- download_url
ProjectUpdateResponse:
type: object
description: ProjectUpdateResponse
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
project:
type: object
description: Project information
properties:
account_id:
type: string
maxLength: 36
description: Account ID
account_name:
type: string
maxLength: 83
description: Account name
address_lines:
type: array
maxItems: 3
description: Address lines
items:
type: string
available_credits:
type: string
description: 'DEPRECATED: Available credits, in USD. Always 0.00, use billing group credits instead'
billing_address:
type: string
maxLength: 1000
description: 'DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead'
billing_currency:
type: string
description: Billing currency
enum:
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- JPY
- NOK
- NZD
- SEK
- SGD
- USD
billing_emails:
type: array
maxItems: 10
description: List of project billing email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
billing_extra_text:
type: string
maxLength: 1000
description: Extra text to be included in all project invoices, e.g. purchase order or cost center number
billing_group_id:
type: string
minLength: 36
maxLength: 36
description: Billing group ID
billing_group_name:
type: string
maxLength: 128
description: Billing group name
card_info:
type: object
description: Credit card assigned to the project
properties:
brand:
type: string
description: Brand
card_id:
type: string
maxLength: 64
description: Credit card ID
country:
type: string
maxLength: 128
description: Country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
exp_month:
type: integer
minimum: 1
maximum: 12
description: Expiration month
exp_year:
type: integer
minimum: 2015
maximum: 2100
description: Expiration year
last4:
type: string
description: Credit card last four digits
name:
type: string
maxLength: 256
description: Name on the credit card
user_email:
type: string
maxLength: 254
description: User email address
required:
- brand
- card_id
- country
- country_code
- exp_month
- exp_year
- last4
- name
- user_email
city:
type: string
maxLength: 50
description: Address city
company:
type: string
maxLength: 83
description: Name of a company
country:
type: string
maxLength: 128
description: Billing country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
default_cloud:
type: string
maxLength: 256
description: Default cloud to use when launching services
end_of_life_extension:
type: object
description: End of life extension information
properties:
elasticsearch:
type: object
description: Service EOL extension
properties:
eol_date:
type: string
description: Extended EOL date
version:
type: string
description: Service version
required:
- eol_date
- version
estimated_balance:
type: string
description: Estimated balance, in USD
estimated_balance_local:
type: string
description: Estimated balance, in billing currency
features:
type: object
description: Feature flags
properties: {}
organization_id:
type: string
maxLength: 36
description: Organization ID
payment_method:
type: string
description: Payment method
project_name:
type: string
maxLength: 63
description: Project name
state:
type: string
maxLength: 30
description: Address state or province
tags:
type: object
description: Set of resource tags
properties: {}
tech_emails:
type: array
maxItems: 10
description: List of project tech email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
tenant_id:
type: string
description: Tenant ID
trial_expiration_time:
type: string
maxLength: 36
description: Trial expiration time (ISO 8601)
vat_id:
type: string
maxLength: 64
description: EU VAT Identification Number
zip_code:
type: string
maxLength: 36
description: Address zip code
required:
- account_id
- billing_address
- billing_emails
- billing_group_id
- billing_group_name
- country
- country_code
- default_cloud
- estimated_balance
- organization_id
- payment_method
- project_name
- vat_id
required:
- project
ProjectDeleteResponse:
type: object
description: ProjectDeleteResponse
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
ProjectPrivatelinkAvailabilityListResponse:
type: object
description: ProjectPrivatelinkAvailabilityListResponse
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
privatelink_availability:
type: array
description: Privatelink pricing information for supported clouds
items:
type: object
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
price_usd:
type: string
description: Hourly privatelink price in this cloud region
required:
- cloud_name
- price_usd
required:
- privatelink_availability
ProjectTagsListResponse:
type: object
description: ProjectTagsListResponse
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
tags:
type: object
description: Set of resource tags
properties: {}
ProjectInviteResponse:
type: object
description: ProjectInviteResponse
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
VpcPeeringConnectionWithRegionDeleteResponse:
type: object
description: VpcPeeringConnectionWithRegionDeleteResponse
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
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
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
VpcPeeringConnectionUpdateRequestBody:
type: object
description: VpcPeeringConnectionUpdateRequestBody
properties:
add:
type: array
maxItems: 128
description: CIDRs to add using a specific peering connection
items:
type: object
properties:
cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
required:
- cidr
- peer_cloud_account
- peer_vpc
delete:
type: array
maxItems: 128
description: Network CIDRs to remove from the VPC's peering connections' user_peer_network_cidrs
items:
type: string
ProjectInviteAcceptResponse:
type: object
description: ProjectInviteAcceptResponse
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
invite_details:
type: object
description: Details of verified invite
properties:
user_email:
type: string
maxLength: 254
description: User email address
required:
- user_email
message:
type: string
description: Printable result of the request
required:
- invite_details
VpcPeeringConnectionDeleteResponse:
type: object
description: VpcPeeringConnectionDeleteResponse
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
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
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
ListProjectVpcPeeringConnectionTypesResponse:
type: object
description: ListProjectVpcPeeringConnectionTypesResponse
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
vpc_peering_connection_types:
type: array
description: Supported VPC peering connection types with pricing information for supported clouds
items:
type: object
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
price_usd:
type: string
description: Hourly peering connection price in this cloud region
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- cloud_name
- price_usd
- vpc_peering_connection_type
required:
- vpc_peering_connection_types
ProjectUserRemoveResponse:
type: object
description: ProjectUserRemoveResponse
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
VpcCreateResponse:
type: object
description: VpcCreateResponse
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
create_time:
type: string
maxLength: 36
description: VPC creation timestamp
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
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peering_connections:
type: array
description: List of peering connections
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
pending_build_only_peering_connections:
type: string
maxLength: 36
description: VPC rebuild is scheduled
project_vpc_id:
type: string
minLength: 36
maxLength: 36
description: Project VPC ID
state:
type: string
description: Project VPC state
enum:
- ACTIVE
- APPROVED
- DELETED
- DELETING
update_time:
type: string
maxLength: 36
description: Timestamp of last change to VPC
required:
- cloud_name
- create_time
- network_cidr
- peering_connections
- project_vpc_id
- state
- update_time
ProjectUpdateRequestBody:
type: object
description: ProjectUpdateRequestBody
properties:
account_id:
type: string
maxLength: 36
description: Account ID
add_account_owners_admin_access:
type: boolean
description: '[DEPRECATED] If account_id is set, grant account owner team admin access to this project. This flag is ignored and assumed true.'
address_lines:
type: array
maxItems: 3
description: '[DEPRECATED] Address lines'
items:
type: string
billing_address:
type: string
maxLength: 1000
description: 'DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead'
billing_currency:
type: string
description: '[DEPRECATED] Billing currency'
enum:
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- JPY
- NOK
- NZD
- SEK
- SGD
- USD
billing_emails:
type: array
maxItems: 10
description: '[DEPRECATED] List of project billing email addresses'
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
billing_extra_text:
type: string
maxLength: 1000
description: '[DEPRECATED] Extra text to be included in all project invoices, e.g. purchase order or cost center number'
billing_group_id:
type: string
minLength: 36
maxLength: 36
description: Billing group ID
card_id:
type: string
maxLength: 64
description: '[DEPRECATED] Credit card ID'
city:
type: string
maxLength: 50
description: '[DEPRECATED] Address city'
cloud:
type: string
maxLength: 256
description: Target cloud
company:
type: string
maxLength: 83
description: '[DEPRECATED] Name of company'
country_code:
type: string
maxLength: 2
description: '[DEPRECATED] Two letter country code for billing country'
project_name:
type: string
maxLength: 63
description: Project name
state:
type: string
maxLength: 30
description: '[DEPRECATED] Address state'
tags:
type: object
description: Set of resource tags
properties: {}
tech_emails:
type: array
maxItems: 10
description: List of project tech email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
vat_id:
type: string
maxLength: 64
description: '[DEPRECATED] EU VAT Identification Number'
zip_code:
type: string
maxLength: 36
description: '[DEPRECATED] Address zip code'
ProjectCreateResponse:
type: object
description: ProjectCreateResponse
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
project:
type: object
description: Project information
properties:
account_id:
type: string
maxLength: 36
description: Account ID
account_name:
type: string
maxLength: 83
description: Account name
address_lines:
type: array
maxItems: 3
description: Address lines
items:
type: string
available_credits:
type: string
description: 'DEPRECATED: Available credits, in USD. Always 0.00, use billing group credits instead'
billing_address:
type: string
maxLength: 1000
description: 'DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead'
billing_currency:
type: string
description: Billing currency
enum:
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- JPY
- NOK
- NZD
- SEK
- SGD
- USD
billing_emails:
type: array
maxItems: 10
description: List of project billing email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
billing_extra_text:
type: string
maxLength: 1000
description: Extra text to be included in all project invoices, e.g. purchase order or cost center number
billing_group_id:
type: string
minLength: 36
maxLength: 36
description: Billing group ID
billing_group_name:
type: string
maxLength: 128
description: Billing group name
card_info:
type: object
description: Credit card assigned to the project
properties:
brand:
type: string
description: Brand
card_id:
type: string
maxLength: 64
description: Credit card ID
country:
type: string
maxLength: 128
description: Country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
exp_month:
type: integer
minimum: 1
maximum: 12
description: Expiration month
exp_year:
type: integer
minimum: 2015
maximum: 2100
description: Expiration year
last4:
type: string
description: Credit card last four digits
name:
type: string
maxLength: 256
description: Name on the credit card
user_email:
type: string
maxLength: 254
description: User email address
required:
- brand
- card_id
- country
- country_code
- exp_month
- exp_year
- last4
- name
- user_email
city:
type: string
maxLength: 50
description: Address city
company:
type: string
maxLength: 83
description: Name of a company
country:
type: string
maxLength: 128
description: Billing country
country_code:
type: string
maxLength: 2
description: Two letter ISO country code
default_cloud:
type: string
maxLength: 256
description: Default cloud to use when launching services
end_of_life_extension:
type: object
description: End of life extension information
properties:
elasticsearch:
type: object
description: Service EOL extension
properties:
eol_date:
type: string
description: Extended EOL date
version:
type: string
description: Service version
required:
- eol_date
- version
estimated_balance:
type: string
description: Estimated balance, in USD
estimated_balance_local:
type: string
description: Estimated balance, in billing currency
features:
type: object
description: Feature flags
properties: {}
organization_id:
type: string
maxLength: 36
description: Organization ID
payment_method:
type: string
description: Payment method
project_name:
type: string
maxLength: 63
description: Project name
state:
type: string
maxLength: 30
description: Address state or province
tags:
type: object
description: Set of resource tags
properties: {}
tech_emails:
type: array
maxItems: 10
description: List of project tech email addresses
items:
type: object
properties:
email:
type: string
maxLength: 254
description: User email address
required:
- email
tenant_id:
type: string
description: Tenant ID
trial_expiration_time:
type: string
maxLength: 36
description: Trial expiration time (ISO 8601)
vat_id:
type: string
maxLength: 64
description: EU VAT Identification Number
zip_code:
type: string
maxLength: 36
description: Address zip code
required:
- account_id
- billing_address
- billing_emails
- billing_group_id
- billing_group_name
- country
- country_code
- default_cloud
- estimated_balance
- organization_id
- payment_method
- project_name
- vat_id
required:
- project
ProjectServiceTypesGetResponse:
type: object
description: ProjectServiceTypesGetResponse
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
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
latest_available_version:
type: string
description: Latest available version of the service
message:
type: string
description: Printable result of the request
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
ProjectTagsUpdateRequestBody:
type: object
description: ProjectTagsUpdateRequestBody
properties:
tags:
type: object
description: Set of resource tags
properties: {}
required:
- tags
VpcPeeringConnectionsRefreshResponse:
type: object
description: VpcPeeringConnectionsRefreshResponse
properties:
cloud_name:
type: string
maxLength: 256
description: Target cloud
create_time:
type: string
maxLength: 36
description: VPC creation timestamp
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
network_cidr:
type: string
maxLength: 18
description: IPv4 network range CIDR
peering_connections:
type: array
description: List of peering connections
items:
type: object
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
pending_build_only_peering_connections:
type: string
maxLength: 36
description: VPC rebuild is scheduled
project_vpc_id:
type: string
minLength: 36
maxLength: 36
description: Project VPC ID
state:
type: string
description: Project VPC state
enum:
- ACTIVE
- APPROVED
- DELETED
- DELETING
update_time:
type: string
maxLength: 36
description: Timestamp of last change to VPC
required:
- cloud_name
- create_time
- network_cidr
- peering_connections
- project_vpc_id
- state
- update_time
ProjectUserUpdateRequestBody:
type: object
description: ProjectUserUpdateRequestBody
properties:
member_type:
type: string
description: Project member type
enum:
- admin
- developer
- operator
- organization:app_users:write
- organization:audit_logs:read
- organization:billing:read
- organization:billing:write
- organization:domains:write
- organization:groups:write
- organization:networking:read
- organization:networking:write
- organization:projects:write
- organization:users:write
- project:audit_logs:read
- project:integrations:read
- project:integrations:write
- project:networking:read
- project:networking:write
- project:permissions:read
- project:services:read
- project:services:write
- read_only
- role:organization:admin
- role:project:admin
- role:services:maintenance
- role:services:recover
- service:configuration:write
- service:data:write
- service:logs:read
- service:metrics:read
- service:secrets:read
- service:users:write
required:
- member_type
ProjectServicePlanSpecsGetResponse:
type: object
description: ProjectServicePlanSpecsGetResponse
properties:
backup_config:
type: object
description: Backup configuration for this service plan
properties:
frequent_interval_minutes:
type: integer
minimum: 0
description: Interval of taking a frequent backup in service types supporting different backup schedules
frequent_oldest_age_minutes:
type: integer
minimum: 0
description: Maximum age of the oldest frequent backup in service types supporting different backup schedules
infrequent_interval_minutes:
type: integer
minimum: 0
description: Interval of taking an infrequent backup in service types supporting different backup schedules
infrequent_oldest_age_minutes:
type: integer
minimum: 0
description: Maximum age of the oldest infrequent backup in service types supporting different backup schedules
interval:
type: integer
minimum: 0
description: The interval, in hours, at which backups are generated. For some services, like PostgreSQL, this is the interval at which full snapshots are taken and continuous incremental backup stream is maintained in addition to that.
max_count:
type: integer
minimum: 0
description: Maximum number of backups to keep. Zero when no backups are created.
recovery_mode:
type: string
description: Mechanism how backups can be restored. 'basic' means a backup is restored as is so that the system is restored to the state it was when the backup was generated. 'pitr' means point-in-time-recovery, which allows restoring the system to any state since the first available full snapshot.
enum:
- basic
- pitr
required:
- interval
- max_count
- recovery_mode
disk_space_cap_mb:
type: integer
minimum: 0
description: Maximum amount of disk space possible for the plan in the given region
disk_space_mb:
type: integer
minimum: 0
description: Combined amount of service disk space of all service nodes in megabytes
disk_space_step_mb:
type: integer
minimum: 1024
description: Disk space change step size
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
max_memory_percent:
type: integer
minimum: 0
maximum: 100
description: Maximum amount of system memory as a percentage (0-100) the service can actually use after taking into account management overhead. This is relevant for memory bound services for which some service management operations require allocating proportional amount of memory on top the basic load.
message:
type: string
description: Printable result of the request
node_count:
type: integer
minimum: 1
maximum: 100
description: Number of nodes in this service plan
primary_count:
type: integer
minimum: 1
description: Number of primary nodes in this Valkey cluster service plan
service_plan:
type: string
maxLength: 128
description: Subscription plan
service_type:
type: string
maxLength: 64
description: Service type code
shard_count:
type: integer
minimum: 1
description: Number of shards in this service plan
required:
- backup_config
- disk_space_mb
- node_count
- service_plan
- service_type
ProjectServicePlanListResponse:
type: object
description: ProjectServicePlanListResponse
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
service_plans:
type: array
description: List of plans available for this type of service
items:
type: object
properties:
backup_config:
type: object
description: Backup configuration for this service plan
properties:
frequent_interval_minutes:
type: integer
minimum: 0
description: Interval of taking a frequent backup in service types supporting different backup schedules
frequent_oldest_age_minutes:
type: integer
minimum: 0
description: Maximum age of the oldest frequent backup in service types supporting different backup schedules
infrequent_interval_minutes:
type: integer
minimum: 0
description: Interval of taking an infrequent backup in service types supporting different backup schedules
infrequent_oldest_age_minutes:
type: integer
minimum: 0
description: Maximum age of the oldest infrequent backup in service types supporting different backup schedules
interval:
type: integer
minimum: 0
description: The interval, in hours, at which backups are generated. For some services, like PostgreSQL, this is the interval at which full snapshots are taken and continuous incremental backup stream is maintained in addition to that.
max_count:
type: integer
minimum: 0
description: Maximum number of backups to keep. Zero when no backups are created.
recovery_mode:
type: string
description: Mechanism how backups can be restored. 'basic' means a backup is restored as is so that the system is restored to the state it was when the backup was generated. 'pitr' means point-in-time-recovery, which allows restoring the system to any state since the first available full snapshot.
enum:
- basic
- pitr
required:
- interval
- max_count
- recovery_mode
is_cluster_plan:
type: boolean
description: True when the plan is a cluster plan with dedicated node groups
max_memory_percent:
type: integer
minimum: 0
maximum: 100
description: Maximum amount of system memory as a percentage (0-100) the service can actually use after taking into account management overhead. This is relevant for memory bound services for which some service management operations require allocating proportional amount of memory on top the basic load.
node_count:
type: integer
minimum: 1
maximum: 100
description: Number of nodes in this service plan
primary_count:
type: integer
minimum: 1
description: Number of primary nodes in this Valkey cluster service plan
regions:
type: object
description: Service plan hourly price per cloud region
properties: {}
service_plan:
type: string
maxLength: 128
description: Subscription plan
service_type:
type: string
maxLength: 64
description: Service type code
shard_count:
type: integer
minimum: 1
description: Number of shards in this service plan
required:
- backup_config
- service_plan
- service_type
required:
- service_plans
ProjectServicePlanPriceGetResponse:
type: object
description: ProjectServicePlanPriceGetResponse
properties:
base_price_usd:
type: string
description: Hourly service price in this region
cloud_name:
type: string
maxLength: 256
description: Target cloud
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
extra_disk_price_per_gb_usd:
type: string
description: Hourly additional disk space price per GiB in this region
message:
type: string
description: Printable result of the request
object_storage_gb_price_usd:
type: string
description: Hourly additional disk space price per GiB in this region
service_plan:
type: string
maxLength: 128
description: Subscription plan
service_type:
type: string
maxLength: 64
description: Service type code
required:
- base_price_usd
- cloud_name
- service_plan
- service_type
ProjectServiceTypesListResponse:
type: object
description: ProjectServiceTypesListResponse
properties:
clickhouse:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
dragonfly:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
elasticsearch:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
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
flink:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
grafana:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
kafka:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
kafka_connect:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
kafka_mirrormaker:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
message:
type: string
description: Printable result of the request
mysql:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
opensearch:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
pg:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
redis:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
thanos:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
valkey:
type: object
description: Service type information
properties:
default_version:
type: string
description: Default version of the service if no explicit version is defined
description:
type: string
description: Single line description of the service
latest_available_version:
type: string
description: Latest available version of the service
user_config_schema:
type: object
description: JSON-Schema for the 'user_config' properties
properties: {}
required:
- description
- user_config_schema
ProjectInviteDeleteResponse:
type: object
description: ProjectInviteDeleteResponse
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
VpcPeeringConnectionCreateResponse:
type: object
description: VpcPeeringConnectionCreateResponse
properties:
create_time:
type: string
maxLength: 36
description: VPC peering connection creation timestamp
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
peer_azure_app_id:
type: string
maxLength: 1024
description: Azure app registration id in UUID4 form that is allowed to create a peering to the peer vnet
peer_azure_tenant_id:
type: string
maxLength: 1024
description: Azure tenant id in UUID4 form
peer_cloud_account:
type: string
maxLength: 1024
description: AWS account ID, GCP project ID, Azure subscription ID of the peered VPC, or string "upcloud" for UpCloud peering connections
peer_region:
type: string
maxLength: 1024
description: The peer VPC's region in AWS clouds. Always null in GCP, Azure, or UpCloud clouds
peer_resource_group:
type: string
maxLength: 1024
description: Azure resource group name of the peered VPC
peer_vpc:
type: string
maxLength: 1024
description: AWS VPC ID, GCP VPC network name, Azure Virtual network name of the peered VPC, or UpCloud VPC ID
peering_connection_id:
type: string
minLength: 36
maxLength: 36
description: VPC peering connection ID
state:
type: string
description: Project VPC peering connection state
enum:
- ACTIVE
- APPROVED
- APPROVED_PEER_REQUESTED
- DELETED
- DELETED_BY_PEER
- DELETING
- ERROR
- INVALID_SPECIFICATION
- PENDING_PEER
- REJECTED_BY_PEER
state_info:
type: object
description: State-specific help or error information
properties:
message:
type: string
description: Human-readable information message
type:
type: string
description: Type of state information
warnings:
type: array
description: List of warnings if any
items:
type: object
properties:
conflicting_aws_account_id:
type: string
description: AWS account id of conflicting VPC
conflicting_aws_vpc_id:
type: string
description: VPC id which is conflicting with the current one
conflicting_aws_vpc_peering_connection_id:
type: string
description: AWS VPC connection id which is conflicting with current VPC
message:
type: string
description: Warning message to be shown to the user
type:
type: string
description: Type of warning
enum:
- overlapping-peer-vpc-ip-ranges
- upcloud-peering-in-error
required:
- message
- type
required:
- message
- type
update_time:
type: string
maxLength: 36
description: Timestamp of last change to the VPC peering connection
user_peer_network_cidrs:
type: array
maxItems: 128
description: List of private IPv4 ranges to route through the peering connection
items:
type: string
vpc_peering_connection_type:
type: string
description: Type of network connection from the VPC
enum:
- aws-tgw-vpc-attachment
- aws-vpc-peering-connection
- azure-vnet-peering
- do-vpc-peering
- google-vpc-peering
- upcloud-vpc-peering
required:
- create_time
- peer_azure_app_id
- peer_azure_tenant_id
- peer_cloud_account
- peer_resource_group
- peer_vpc
- state
- state_info
- update_time
- user_peer_network_cidrs
- vpc_peering_connection_type
parameters:
invited_email:
in: path
name: invited_email
description: Email address of user to be invited
schema:
type: string
required: true
peer_cloud_account:
in: path
name: peer_cloud_account
description: AWS account ID, Google project name, Azure subscription ID, or string "upcloud" for UpCloud peering connections
schema:
type: string
required: true
cloud:
in: path
name: cloud
description: Cloud
schema:
type: string
required: true
peer_vpc:
in: path
name: peer_vpc
description: AWS VPC-ID, Google network name, Azure VNet name, or UpCloud VPC ID
schema:
type: string
required: true
download_cookie:
in: path
name: download_cookie
description: Authentication cookie for file download
schema:
type: string
required: true
project_vpc_id:
in: path
name: project_vpc_id
description: Project VPC ID
schema:
type: string
required: true
service_plan:
in: path
name: service_plan
description: Service plan
schema:
type: string
required: true
peer_resource_group:
in: path
name: peer_resource_group
description: Azure resource group
schema:
type: string
required: true
peer_region:
in: path
name: peer_region
description: AWS region
schema:
type: string
required: true
file_format:
in: path
name: file_format
description: of the SBOM report
schema:
type: string
required: true
service_type:
in: path
name: service_type
description: Service type
schema:
type: string
required: true
project:
in: path
name: project
description: Project name
schema:
type: string
required: true
invite_verification_code:
in: path
name: invite_verification_code
description: Verification code received via email
schema:
type: string
required: true
user_email:
in: path
name: user_email
description: Email address
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