NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

DigitalOcean

digital_ocean

DigitalOcean is a cloud infrastructure provider offering scalable compute platforms with a user-friendly interface.

Developer ToolsServer MonitoringWeb del proveedor
Acciones
47
Triggers
0
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (47)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create Custom ImageDIGITAL_OCEAN_CREATE_CUSTOM_IMAGEAcción

Tool to create a new custom image by providing a url to a linux vm image. use when you need to import a vm image into digitalocean after specifying name, url, distribution, and region.

Parámetros de entrada

  • urlanyObligatoriouri

    Publicly accessible URL of the raw disk image file.

  • namestringObligatorio

    A descriptive name for the image.

  • tagsstring[]

    Tags to apply to the image.

  • regionstringObligatorio

    Slug identifier for the region where the image should be created.

  • descriptionstring

    Detailed description of the image.

  • distributionstringObligatorio

    Operating system distribution (e.g., Ubuntu, Fedora).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Database ClusterDIGITAL_OCEAN_CREATE_DATABASE_CLUSTERAcción

Tool to create a new managed database cluster. use when you need to provision a database cluster with name, engine, version, region, size, and number of nodes.

Parámetros de entrada

  • namestringObligatorio

    Name for your database cluster

  • sizestringObligatorio

    Size slug for the database nodes

  • tagsstring[]

    Tags to assign to the cluster

  • enginestringObligatorioenum

    Database engine (e.g., 'pg', 'mysql', 'redis')

    pgmysqlredis
  • regionstringObligatorio

    Region slug where the cluster will be created

  • versionstringObligatorio

    Engine version (e.g., '13')

  • db_namesstring[]

    Names of databases to create in the cluster

  • sql_modestring

    SQL mode for MySQL clusters

  • num_nodesintegerObligatorio

    Number of nodes in the cluster

  • user_namesstring[]

    Usernames to create in the cluster

  • backup_restoreobject

    Configuration to restore a cluster from a backup

  • eviction_policystring

    Eviction policy for Redis clusters

  • storage_size_gbinteger

    Additional storage size in GiB for the cluster

  • maintenance_windowobject

    Maintenance window configuration for the cluster

  • private_network_uuidstring

    UUID of VPC network for private networking

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New Block Storage VolumeDIGITAL_OCEAN_CREATE_NEW_BLOCK_STORAGE_VOLUMEAcción

Tool to create a new block storage volume. use when you need to provision persistent block storage after confirming the target region supports volumes. example: "create a 100 gib ext4 backup volume named 'db-backup' in nyc1."

Parámetros de entrada

  • namestringObligatorio

    A human-readable name for the block storage volume.

  • tagsstring[]

    List of tags to apply to the volume.

  • regionstringObligatorio

    Slug identifier for the region where the volume will be created (e.g., 'nyc1').

  • descriptionstring

    Free-form text description of the volume.

  • snapshot_idstring

    Unique identifier of a snapshot to create the volume from.

  • size_gigabytesintegerObligatorio

    Size of the block storage volume in GiB (minimum 1).

  • filesystem_typestring

    Filesystem type to initialize on the volume (e.g., 'ext4').

  • filesystem_labelstring

    Label to apply to the filesystem.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New DomainDIGITAL_OCEAN_CREATE_NEW_DOMAINAcción

Tool to create a new domain. use when you have the domain name and optionally an ip address to assign an a record.

Parámetros de entrada

  • namestringObligatorio

    The domain name to create, e.g., 'example.com'.

  • ip_addressstring

    Optional IPv4 address for an A record for the domain.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Domain RecordDIGITAL_OCEAN_CREATE_NEW_DOMAIN_RECORDAcción

Tool to create a new dns record for a domain. use after confirming domain exists and record specifics.

Parámetros de entrada

  • tagstring

    Tag for CAA records (issue, issuewild, iodef); required if type is CAA

  • ttlinteger

    Time to live for the record in seconds

  • datastringObligatorio

    Value of the DNS record. Format depends on the record type

  • namestring

    Host name for the record (e.g., 'www'). Omit for root domain

  • portinteger

    Port for SRV records; required if type is SRV

  • typestringObligatorioenum

    Type of DNS record to create

    AAAAACNAMEMXTXTNSSRVCAA
  • flagsinteger

    Flags for CAA records; required if type is CAA

  • weightinteger

    Weight for SRV records; required if type is SRV

  • priorityinteger

    Priority for MX and SRV records; required if type is MX or SRV

  • domain_namestringObligatorio

    The domain name to add the record to, e.g., 'example.com'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New DropletDIGITAL_OCEAN_CREATE_NEW_DROPLETAcción

Tool to create a new droplet. use when you need to provision a vm with name, region, size, and image.

Parámetros de entrada

  • ipv6boolean

    Whether IPv6 is enabled

  • namestringObligatorio

    A human-readable name for the Droplet

  • sizestringObligatorio

    Size slug for the Droplet

  • tagsstring[]

    List of tags to apply to the Droplet

  • imagestringObligatorio

    Image slug or ID to use for the Droplet

  • regionstringObligatorio

    Region slug where the Droplet will be created

  • backupsboolean

    Whether automatic backups are enabled

  • volumesstring[]

    IDs of volumes to attach to the Droplet

  • ssh_keysarray

    List of SSH key IDs or fingerprints to embed

  • vpc_uuidstring

    VPC UUID to assign the Droplet to

  • user_datastring

    User data (cloud-init) script to configure the Droplet

  • monitoringboolean

    Whether monitoring is enabled

  • private_networkingboolean

    Deprecated: use 'vpc_uuid' instead

  • with_droplet_agentboolean

    Whether to install the Droplet agent for metrics

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New FirewallDIGITAL_OCEAN_CREATE_NEW_FIREWALLAcción

Tool to create a new firewall. use when you need to define a firewall name and custom rules (requires at least one inbound and one outbound rule).

Parámetros de entrada

  • namestringObligatorio

    Name of the new firewall.

  • tagsstring[]

    Optional list of Droplet tags to apply the firewall to matching droplets.

  • vpc_uuidstring

    Optional VPC UUID to scope this firewall to a VPC.

  • droplet_idsinteger[]

    Optional list of Droplet IDs to apply the firewall to.

  • inbound_rulesobject[]Obligatorio

    List of inbound rules; must contain at least one.

  • outbound_rulesobject[]Obligatorio

    List of outbound rules; must contain at least one.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New Kubernetes ClusterDIGITAL_OCEAN_CREATE_NEW_KUBERNETES_CLUSTERAcción

Tool to create a new kubernetes cluster. use when you have finalized the cluster name, region, version, and at least one node pool. confirm region supports kubernetes clusters before use.

Parámetros de entrada

  • namestringObligatorio

    A human-readable name for the Kubernetes cluster.

  • tagsstring[]

    List of tags to apply to the cluster.

  • regionstringObligatorio

    Region slug where the cluster will be created (e.g., 'nyc1').

  • versionstringObligatorio

    Kubernetes version slug to deploy (e.g., '1.21.5-do.0').

  • node_poolsobject[]Obligatorio

    List of node pools; at least one required.

  • auto_upgradeboolean

    Whether to auto-upgrade to new patch releases.

  • maintenance_policyobject

    Scheduled maintenance policy for the cluster.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New SSH KeyDIGITAL_OCEAN_CREATE_NEW_SSH_KEYAcción

Tool to create a new ssh key. use when you need to register a public key to access droplets.

Parámetros de entrada

  • namestringObligatorio

    A human-readable name for the new SSH key.

  • public_keyanyObligatorio

    The SSH public key in OpenSSH format, e.g., 'ssh-rsa AAAAB3Nza...'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New TagDIGITAL_OCEAN_CREATE_NEW_TAGAcción

Tool to create a new tag. use when you need to organize resources by grouping them under a custom tag. ensure the tag name passes validation before calling. example: "create a new tag named analytics".

Parámetros de entrada

  • namestringObligatorio

    The name of the new tag. Must be 1-255 characters and only contain alphanumeric characters, ':', '.', or '-'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New VPCDIGITAL_OCEAN_CREATE_NEW_VPCAcción

Tool to create a new vpc. use when you need to provision a private network in a specific region.

Parámetros de entrada

  • namestringObligatorio

    The name of the VPC.

  • tagsstring[]

    List of tag names to apply to the VPC after creation.

  • regionstringObligatorio

    Slug identifier for the region where the VPC will be created.

  • ip_rangestring

    The IP range in CIDR notation for the VPC (default is 10.10.10.0/24).

  • descriptionstring

    A free-form description of the VPC.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Block Storage VolumeDIGITAL_OCEAN_DELETE_BLOCK_STORAGE_VOLUMEAcción

Tool to delete a block storage volume by id. use when you need to permanently remove an existing block storage volume after confirming its id. returns http 204 no content on success.

Parámetros de entrada

  • regionstring

    The slug identifier for the region; required only if deleting by name.

  • volume_idstringObligatorio

    The unique identifier of the block storage volume to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Database ClusterDIGITAL_OCEAN_DELETE_DATABASE_CLUSTERAcción

Tool to delete a database cluster by uuid. use when you have confirmed the cluster is no longer needed. returns http 204 no content on success.

Parámetros de entrada

  • database_cluster_uuidstringObligatorio

    The UUID of the database cluster to destroy

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete DomainDIGITAL_OCEAN_DELETE_DOMAINAcción

Tool to delete a domain by name. use when you have confirmed the domain has no records assigned. returns 204 no content on success.

Parámetros de entrada

  • namestringObligatorio

    The fully qualified domain name to delete, e.g., 'example.com'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Domain RecordDIGITAL_OCEAN_DELETE_DOMAIN_RECORDAcción

Tool to delete a dns record by its record id for a domain. use when you need to remove an existing dns record and have the domain name and record id. returns http 204 no content on success.

Parámetros de entrada

  • namestringObligatorio

    The domain name (e.g., 'example.com').

  • record_idintegerObligatorio

    The unique identifier of the DNS record to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Existing DropletDIGITAL_OCEAN_DELETE_EXISTING_DROPLETAcción

Tool to delete a droplet by id. use when you need to permanently remove an existing droplet after confirming its id to avoid unintended deletions.

Parámetros de entrada

  • droplet_idintegerObligatorio

    Unique identifier of the Droplet to delete

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete FirewallDIGITAL_OCEAN_DELETE_FIREWALLAcción

Tool to delete a firewall by id. use when you have confirmed the firewall is no longer needed.

Parámetros de entrada

  • firewall_idstringObligatorio

    Unique identifier of the firewall to delete

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete ImageDIGITAL_OCEAN_DELETE_IMAGEAcción

Tool to delete a snapshot or custom image by id. use when cleaning up unused images after confirming there are no dependents.

Parámetros de entrada

  • image_idintegerObligatorio

    A unique number used to identify and delete an image.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Load BalancerDIGITAL_OCEAN_DELETE_LOAD_BALANCERAcción

Tool to delete a load balancer instance by id. use when you need to permanently remove an existing load balancer after confirming its id. returns 204 no content on success.

Parámetros de entrada

  • load_balancer_idstringObligatorio

    Unique identifier of the load balancer to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete SSH KeyDIGITAL_OCEAN_DELETE_SSH_KEYAcción

Tool to delete a public ssh key. use when you need to remove an ssh key from your account by its id or fingerprint after confirming its ownership. returns 204 no content on success.

Parámetros de entrada

  • key_id_or_fingerprintstringObligatorio

    The identifier for the SSH key (numeric ID or fingerprint).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete TagDIGITAL_OCEAN_DELETE_TAGAcción

Tool to delete a tag by name. use when you need to untag all resources previously tagged. returns 204 no content on success.

Parámetros de entrada

  • namestringObligatorio

    The name of the tag to delete; all resources with this tag will be untagged.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete VPCDIGITAL_OCEAN_DELETE_VPCAcción

Tool to delete a vpc by its id. use when you need to remove an existing virtual private cloud. returns 204 no content on success.

Parámetros de entrada

  • vpc_idstringObligatorio

    Unique identifier of the VPC to delete

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create New Load BalancerDIGITAL_OCEAN_DIGITAL_OCEAN_CREATE_NEW_LOAD_BALANCERAcción

Tool to create a new load balancer. use after specifying region, forwarding rules, and targets.

Parámetros de entrada

  • tagstring

    Tag to select droplets (mutually exclusive with droplet_ids).

  • namestringObligatorio

    Unique name for the new load balancer.

  • regionstringObligatorio

    Region slug where the load balancer will be created (e.g., 'nyc1').

  • vpc_uuidstring

    UUID of the VPC to assign the load balancer to.

  • algorithmstringenum

    Load balancing algorithm to use; defaults to 'round_robin'.

    round_robinleast_connections
  • droplet_idsinteger[]

    List of droplet IDs to attach (mutually exclusive with tag).

  • health_checkobject

    Optional health check configuration.

  • firewall_policystring

    ID of a custom firewall policy to apply.

  • sticky_sessionsobject

    Optional session persistence configuration.

  • forwarding_rulesobject[]Obligatorio

    List of forwarding rules mapping entry to target protocols and ports.

  • enable_proxy_protocolboolean

    Enable PROXY protocol for backend connections.

  • redirect_http_to_httpsboolean

    Redirect HTTP traffic to HTTPS.

  • enable_backend_keepaliveboolean

    Enable keepalive connections to backend droplets.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Domain RecordsDIGITAL_OCEAN_DIGITAL_OCEAN_LIST_DOMAIN_RECORDSAcción

Tool to list all dns records for a domain. use when you need to inspect or filter a domain's dns configuration.

Parámetros de entrada

  • namestringObligatorio

    Filter records by record name (e.g., 'www').

  • pageinteger

    Page of results to return (>= 1).

  • typestringenum

    Filter records by DNS record type.

    AAAAACNAMEMXNSTXTSRVLOCCAA
  • per_pageinteger

    Number of results per page (1-200).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All DatabasesDIGITAL_OCEAN_LIST_ALL_DATABASESAcción

Tool to list all managed database clusters on your account. use when you need to retrieve clusters and support pagination or filtering by tag.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (starting from 1).

  • per_pageinteger

    Number of items to return per page. Must be between 1 and 200.

  • tag_namestring

    Filter to return only database clusters with this tag name.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All DomainsDIGITAL_OCEAN_LIST_ALL_DOMAINSAcción

Tool to list all domains in your digitalocean account. use when you need to retrieve or iterate through domains, with optional pagination. use after authentication.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (starting from 1).

  • per_pageinteger

    Number of domains to return per page (1-200). Default is 20 if omitted.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All DropletsDIGITAL_OCEAN_LIST_ALL_DROPLETSAcción

Tool to list all droplets in your account. use when you need an overview of droplets, optionally filtered by tag. use after authentication.

Parámetros de entrada

  • pageinteger

    Page of results to return. Must be >= 1. Default is 1.

  • per_pageinteger

    Number of items per page. Must be between 1 and 200. Default is 20.

  • tag_namestring

    Filter droplets by tag name.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All FirewallsDIGITAL_OCEAN_LIST_ALL_FIREWALLSAcción

Tool to list all firewalls on your digitalocean account. use when you need to audit or manage firewall rules with optional pagination.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (starting from 1).

  • per_pageinteger

    Number of firewalls to return per page (1-200).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All ImagesDIGITAL_OCEAN_LIST_ALL_IMAGESAcción

Tool to list all images available on your account. use after obtaining a valid api token to retrieve images optionally filtered by type, private visibility, or tag name.

Parámetros de entrada

  • pageinteger

    Page number to return. Default: 1. Minimum: 1.

  • typestringenum

    Filter images by type. Valid values: 'distribution', 'application', 'private'.

    distributionapplicationprivate
  • privateboolean

    If true, returns only private images. Defaults to false.

  • per_pageinteger

    Number of results per page. Default: 20. Range: 1200.

  • tag_namestring

    Return only images tagged with this tag.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All Kubernetes ClustersDIGITAL_OCEAN_LIST_ALL_KUBERNETES_CLUSTERSAcción

Tool to list all kubernetes clusters on your account. use when you need to enumerate every cluster and handle pagination.

Parámetros de entrada

  • pageinteger

    Page number of paginated results (starting from 1).

  • per_pageinteger

    Number of clusters per page. Must be between 1 and 200.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All Load BalancersDIGITAL_OCEAN_LIST_ALL_LOAD_BALANCERSAcción

Tool to list all load balancer instances on your account. use when you need a paginated overview of load balancers after authentication.

Parámetros de entrada

  • pageinteger

    Page of results to return. Must be >= 1. Default is 1.

  • per_pageinteger

    Number of items per page. Must be between 1 and 200. Default is 20.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All SnapshotsDIGITAL_OCEAN_LIST_ALL_SNAPSHOTSAcción

Tool to list all snapshots available on your digitalocean account. use when you need to fetch and optionally filter snapshots by resource type (droplet or volume) and handle pagination for inventory or backup workflows.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (starting from 1).

  • per_pageinteger

    Number of snapshots to return per page (1-200).

  • resource_typestringenum

    Filter snapshots by resource type; either 'droplet' or 'volume'.

    dropletvolume

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All SSH KeysDIGITAL_OCEAN_LIST_ALL_SSH_KEYSAcción

Tool to list all ssh keys in your account. use when you need to retrieve ssh key metadata.

Parámetros de entrada

  • pageinteger

    Page of results to return (starting from 1).

  • per_pageinteger

    Number of results per page (1-200).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All TagsDIGITAL_OCEAN_LIST_ALL_TAGSAcción

Tool to list all tags in your account. use when you need to retrieve available tags and pagination info.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (starting from 1).

  • per_pageinteger

    Number of items returned per page. Must be between 1 and 200.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All VolumesDIGITAL_OCEAN_LIST_ALL_VOLUMESAcción

Tool to list all block storage volumes available on your account. use when you need to retrieve volumes and optionally filter by name and region.

Parámetros de entrada

  • namestring

    Filter to return only volumes with this exact name.

  • pageinteger

    Page number to retrieve (starting from 1).

  • regionstring

    Filter to return only volumes in this region (region slug).

  • per_pageinteger

    Number of items returned per page. Must be between 1 and 200.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List All VPCsDIGITAL_OCEAN_LIST_ALL_VPCSAcción

Tool to list all vpcs on your account. use when you need an inventory of your vpc resources; supports pagination.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (default: 1).

  • per_pageinteger

    Number of VPCs to return per page (default: 20, max: 200).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Database OptionsDIGITAL_OCEAN_LIST_DATABASE_OPTIONSAcción

Tool to list valid database engine, version, region, and size options. use when configuring a new managed database cluster.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve DomainDIGITAL_OCEAN_RETRIEVE_DOMAINAcción

Tool to retrieve details about a specific domain by its name. use after creating or importing a domain to verify ttl and zone file configuration.

Parámetros de entrada

  • namestringObligatorio

    The fully qualified domain name (e.g., 'example.com').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve Domain RecordDIGITAL_OCEAN_RETRIEVE_DOMAIN_RECORDAcción

Tool to retrieve a specific dns record for a domain by its record id. use when you have the domain name and record id to fetch record details.

Parámetros de entrada

  • namestringObligatorio

    The domain name (e.g., 'example.com').

  • record_idintegerObligatorio

    The unique identifier for the DNS record.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve Existing DropletDIGITAL_OCEAN_RETRIEVE_EXISTING_DROPLETAcción

Tool to show information about an individual droplet by id. use when you have a droplet id and need detailed status.

Parámetros de entrada

  • droplet_idintegerObligatorio

    A unique numeric ID for the Droplet to retrieve

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve Existing ImageDIGITAL_OCEAN_RETRIEVE_EXISTING_IMAGEAcción

Tool to retrieve information about an image by id or slug. use when you need detailed metadata for a known image.

Parámetros de entrada

  • image_idintegerObligatorio

    The unique numeric ID or slug of the image to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve TagDIGITAL_OCEAN_RETRIEVE_TAGAcción

Tool to retrieve an individual tag by name. use when you need to inspect the resources grouped under a specific tag.

Parámetros de entrada

  • namestringObligatorio

    The name of the tag to retrieve (case-sensitive).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve VPCDIGITAL_OCEAN_RETRIEVE_VPCAcción

Tool to retrieve details about a specific vpc by its id. use when you need to inspect vpc properties for configuration or auditing.

Parámetros de entrada

  • vpc_uuidstringObligatorio

    The unique identifier of the VPC.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Tag ResourceDIGITAL_OCEAN_TAG_RESOURCEAcción

Tool to tag resources by name. use when you need to assign an existing tag to one or more resources. returns 204 no content on success.

Parámetros de entrada

  • tag_namestringObligatorio

    The name of the tag to which resources will be assigned

  • resourcesobject[]Obligatorio

    List of resources to assign the tag to (each with id and type)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Untag ResourceDIGITAL_OCEAN_UNTAG_RESOURCEAcción

Tool to untag resources by tag name. use when you need to remove an existing tag from multiple resources in a single operation.

Parámetros de entrada

  • tag_namestringObligatorio

    Name of the tag to remove from the specified resources.

  • resourcesobject[]Obligatorio

    List of resource objects to untag, each with id, type, and optional region.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Domain RecordDIGITAL_OCEAN_UPDATE_DOMAIN_RECORDAcción

Tool to update an existing dns record for a domain. use when you need to modify any valid attribute of a record after confirming its record id.

Parámetros de entrada

  • tagstring

    Tag for CAA records.

  • ttlinteger

    Time to live of the record in seconds.

  • datastring

    The value of the DNS record (e.g., IP address for A/AAAA record).

  • namestring

    The host name for the record (e.g., 'www', '@').

  • portinteger

    Port for SRV records.

  • typestring

    The DNS record type (e.g., 'A', 'CNAME', 'TXT', 'MX', 'SRV', 'CAA').

  • flagsinteger

    Flags for CAA records.

  • weightinteger

    Weight for SRV records.

  • priorityinteger

    Priority for MX records.

  • record_idintegerObligatorio

    The unique identifier for the DNS record.

  • domain_namestringObligatorio

    The domain name (e.g., 'example.com').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update VPCDIGITAL_OCEAN_UPDATE_VPCAcción

Tool to update information about a vpc. use when you need to modify the name, description, or default status of an existing vpc.

Parámetros de entrada

  • namestring

    The new name for the VPC.

  • vpc_idstringObligatorio

    The unique identifier of the VPC to update.

  • defaultboolean

    Whether to set this VPC as the default for its region.

  • descriptionstring

    A free-form text description for the VPC.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not