Call any ArvanCloud API endpoint directly (generic escape hatch).

Use this for any operation that does not have a dedicated tool. Discover available endpoints with arvan_capabilities.

Args: method: HTTP method. path: Endpoint path relative to the API base, e.g. /ecc/v1/regions/ir-thr-c2/servers or /cdn/4.0/domains. A leading slash is optional. query: Optional query-string parameters. body: Optional JSON request body (for POST/PUT/PATCH).

Returns: The decoded JSON response from ArvanCloud.

Discover ArvanCloud products and their API endpoints.

Call without arguments for a compact overview of every service. Pass a service key (compute, network, storage, cdn, dns, vod, live) to get its full endpoint list, including request-body hints you can feed to arvan_request.

Diagnose the server's configuration and connectivity.

Checks: whether the API key works (a live call), which optional CLI tools are installed (IaC/security/k8s/git/net), and whether Object Storage and SSH defaults are configured. Run this first to see what's ready to use.

Search this server's own tools by keyword (handy with 200+ tools).

Returns matching tool names and one-line descriptions, ranked by relevance.

List all ArvanCloud IaaS regions (datacenters) and their codes.

Get the current account/project details for Cloud Server.

Get resource quotas and current usage for a region.

List cloud servers (VMs) in a region.

Get details of a single cloud server by id.

Get available options for creating a server in a region.

Create one or more cloud servers.

Args: name: Server name (a numeric suffix is added when count > 1). flavor_id: Plan/flavor id — see arvan_list_plans. image_id: OS/snapshot image id — see arvan_list_images. region: Region code; defaults to ARVAN_DEFAULT_REGION. disk_size: Root disk size in GB. count: How many identical servers to create. network_ids: Private network ids to attach. security_group_names: Security groups to apply. ssh_key_name: Name of an SSH key to inject (see arvan_list_ssh_keys). init_script: Cloud-init / startup script. ha_enabled: Enable high availability. create_type: Optional create type (e.g. image, snapshot). extra: Any additional fields to merge into the request body.

Delete a cloud server. Set force_delete_floating_ips to also release IPs.

Run a power/maintenance action on a server.

Actions: power-on, power-off, reboot, hard-reboot, rescue, unrescue, reset-root-password, add-public-ip, change-public-ip.

Rename a cloud server.

Rebuild a server from an image (destroys current root disk contents).

Change a server's plan/flavor (resize CPU & RAM).

Resize a server's root disk to the given size in GB.

List server images.

Args: region: Region code; defaults to ARVAN_DEFAULT_REGION. image_type: Filter by type, e.g. distributions (OS images), snapshots (your snapshots), or private. marketplace: Set True to list marketplace app images instead.

List available server plans/flavors (sizes) and their pricing.

List reverse-DNS (PTR) records in a region.

Create a reverse-DNS (PTR) record mapping an IP to a domain.

Delete a reverse-DNS (PTR) record by id.

List SSH keys registered in a region (for injecting into new servers).

Register an SSH public key so it can be injected into servers at create.

Delete a registered SSH key by name.

List resource tags in a region.

Create a resource tag.

Delete a resource tag by id.

Attach a tag to a resource (e.g. a server).

Detach a tag from a resource.

Attach a security group to a server.

Detach a security group from a server.

Poll a server until it becomes active (or the timeout elapses).

Handy right after arvan_create_server and before SSHing in. Returns the latest server details plus ready/timed_out flags. The wait is bounded to 30 minutes regardless of timeout.

List networks (public and private) available in a region.

List private-network subnets in a region.

Create a private network (subnet).

Args: name: Network name. region: Region code; defaults to ARVAN_DEFAULT_REGION. subnet_ip: CIDR for the subnet, e.g. 192.168.0.0/24. subnet_gateway: Gateway IP within the subnet. enable_gateway: Whether to enable the gateway. enable_dhcp: Whether DHCP assigns addresses automatically. dns_servers: Comma-separated DNS servers. dhcp_start / dhcp_end: Optional DHCP allocation range.

Get a private-network subnet by id.

Update a subnet (e.g. dns_servers, enable_dhcp, subnet_gateway).

Delete a private-network subnet by id.

Attach a network to a server (optionally with a fixed IP).

Detach a network from a server.

List security groups (firewall groups) in a region.

Create a security group.

Delete a security group by id.

Add a rule to a security group.

Args: group_id: Target security-group id. direction: ingress (inbound) or egress (outbound). protocol: tcp, udp, icmp … (omit for any). port_from / port_to: Port range (as strings). ips: Source/destination CIDRs, e.g. ["0.0.0.0/0"]. description: Optional description.

Delete a security-group rule by id.

List floating (public) IP addresses in a region.

Allocate a new floating (public) IP address.

Attach a floating IP to a server/port.

Detach a floating IP from the given port.

Release (delete) a floating IP address by id.

Enable or disable port security on a network port.

List block-storage volumes in a region.

Get a single block-storage volume by id.

Get block-storage volume limits/quota for a region.

Create a block-storage volume.

Args: name: Volume name. size: Size in GB. region: Region code; defaults to ARVAN_DEFAULT_REGION. description: Optional description.

Update a volume's name and/or description.

Delete a block-storage volume by id.

Attach a volume to a server.

Detach a volume from a server.

Create a snapshot of a volume.

List all Object Storage buckets.

Create a bucket. acl is one of private, public-read, public-read-write.

Delete an (empty) bucket.

List objects in a bucket (optionally under a prefix).

Upload an object.

Args: bucket: Target bucket. key: Object key (path) within the bucket. content: The object body. Plain text, or base64 if content_base64. content_base64: Set True when content is base64-encoded binary. content_type: Optional MIME type, e.g. application/json. acl: Optional ACL, e.g. public-read.

Download an object. Returns text, or base64 when as_base64 or binary.

Bodies larger than 256 KiB are truncated; use a presigned URL for big files.

Delete a single object.

Delete multiple objects in one call.

Copy an object to another key/bucket.

Get an object's metadata (size, type, etag) without downloading it.

Generate a presigned URL for temporary access to an object.

operation is get_object (download) or put_object (upload).

Get a bucket's access policy (JSON).

Set a bucket's access policy (an S3 policy document).

Set a bucket ACL (private, public-read, public-read-write).

Upload all files under a local directory to a bucket (recursive).

Configure a bucket for static website hosting (optionally make it public).

List CDN domains on the account (supports pagination & search).

Get details and settings for a CDN domain.

Add a domain to the CDN / Cloud DNS (the "dns-service" onboarding call).

Args: domain: The domain name, e.g. example.com. extra: Additional fields to merge into the request body (e.g. plan).

Remove a domain from the CDN.

The delete endpoint requires the domain's id. If domain_id is not supplied it is looked up automatically via the domain details.

Get caching settings for a domain.

Update caching settings for a domain.

settings accepts the caching fields documented by ArvanCloud, e.g. {"cache_status": "enable", "cache_page_200": "..."}.

Purge cached content for a domain.

Pass urls to purge specific paths, or omit to purge everything.

List page rules for a domain.

Create a page rule.

Args: domain: The CDN domain. url: URL pattern the rule applies to (e.g. example.com/blog/*). actions: Map of rule actions, e.g. {"cache_level": "bypass"}.

Delete a page rule by id.

List firewall (WAF) rules for a domain.

Create a firewall (WAF) rule.

Args: domain: The CDN domain. name: Rule name. action: Action to take, e.g. block, allow, challenge. filters: Match conditions for the rule. extra: Additional fields to merge into the request body.

Get HTTPS/SSL settings for a domain.

Update HTTPS/SSL settings for a domain.

Pass ssl_type (default for free Let's Encrypt, manual for an uploaded certificate, off to disable) and/or a full settings body.

Delete a firewall (WAF) rule by id.

List rate-limit rules for a domain.

Create a rate-limit rule.

rule carries the documented fields (e.g. url, method, count, duration, action).

Delete a rate-limit rule by id.

List log-forwarding destinations for a domain.

Create a log forwarder (ship access logs to an external sink).

Delete a log forwarder by id.

List Prometheus-style metric exporters for a domain.

Create a metric exporter for a domain.