Cloud API Reference

Customer-hosted cloud features

note

Some features are only available on customer-hosted clouds. Reach out to support@anyscale.com for info.

Cloud CLI

anyscale cloud setup

Usage

anyscale cloud setup [OPTIONS]

Set up a cloud provider.

Options

• --provider: The cloud provider type.
• --region: Region to set up the credentials in.
• --name/-n: Name of the cloud.
• --project-id: Globally Unique project ID for GCP clouds (e.g., my-project-abc123)
• --functional-verify: Verify the cloud is functional. This will check that the cloud can launch workspace/service.
• --anyscale-managed: Let anyscale create all the resources.
• --enable-head-node-fault-tolerance: Whether to enable head node fault tolerance for services.
• --yes/-y: Skip asking for confirmation.
• --disable-auto-add-user: All users in the organization will be added to clouds created with anyscale cloud setup by default. Specify --disable-auto-add-user to disable this and instead manually grant users permissions to the cloud.

anyscale cloud register

Usage

anyscale cloud register [OPTIONS]

Register an anyscale cloud with your own resources.

Options

• --provider: The cloud provider type.
• --region: Region to set up the credentials in.
• --compute-stack: The compute stack type (VM or K8S).
• --name/-n: Name of the cloud.
• --vpc-id: The ID of the VPC.
• --subnet-ids: Comma separated list of subnet ids.
• --file-storage-id: File storage ID (e.g. EFS ID for AWS, Filestore instance ID for GCP)
• --efs-id: The EFS ID.
• --anyscale-iam-role-id: The Anyscale IAM Role ARN.
• --instance-iam-role-id: The instance IAM role ARN.
• --security-group-ids: IDs of the security groups.
• --s3-bucket-id: S3 bucket ID.
• --external-id: The trust policy external ID for the cross account IAM role.
• --memorydb-cluster-id: Memorydb cluster ID
• --project-id: Globally Unique project ID for GCP clouds (e.g., my-project-abc123)
• --vpc-name: VPC name for GCP clouds
• --subnet-names: Comma separated list of subnet names for GCP clouds
• --filestore-instance-id: Filestore instance ID for GCP clouds.
• --filestore-location: Filestore location for GCP clouds.
• --anyscale-service-account-email: Anyscale service account email for GCP clouds.
• --instance-service-account-email: Instance service account email for GCP clouds.
• --provider-name: Workload Identity Federation provider name for Anyscale access.
• --firewall-policy-names: Filewall policy names for GCP clouds
• --cloud-storage-bucket-name: A fully qualified storage bucket name for cloud storage, e.g. s3://bucket-name, gs://bucket-name, or azure://bucket-name.
• --cloud-storage-bucket-endpoint: An endpoint for cloud storage, e.g. used to override the default cloud storage scheme's endpoint (e.g. for S3, this would be passed to the AWS_ENDPOINT_URL environment variable).
• --cloud-storage-bucket-region: The region of the cloud storage bucket. If not provided, the region of the cloud will be used to access the cloud storage bucket.
• --nfs-mount-target: A comma-separated value representing a (zone, mount target) tuple, e.g. us-west-2a,1.2.3.4 (may be provided multiple times, one for each zone). If only one value is provided (e.g. 1.2.3.4), then that value will be used for all zones.
• --nfs-mount-path: The path of the NFS server to mount from (e.g. nfs-target-address/nfs-path will be mounted).
• --memorystore-instance-name: Memorystore instance name for GCP clouds
• --host-project-id: Host project ID for shared VPC
• --kubernetes-zones: On the Kubernetes compute stack, a comma-separated list of zones to launch pods in.
• --anyscale-operator-iam-identity: On the Kubernetes compute stack, the cloud provider IAM identity federated with the Anyscale Operator's kubernetes service account, which will be used by Anyscale control plane for validation during Anyscale Operator bootstrap in the dataplane. IN AWS EKS, this is the ARN of the IAM role. For GCP GKE, this is the service account email.
• --private-network: Use private network.
• --functional-verify: Verify the cloud is functional. This will check that the cloud can launch workspace/service.
• --yes/-y: Skip asking for confirmation.
• --skip-verifications: Skip verifications. This will skip all verifications.
• --enable-auto-add-user: If --enable-auto-add-user is specified for a cloud, all users in the organization will be added to the cloud by default. Otherwise users will need to be manually granted permissions to the cloud. Note: There may be up to 30 sec delay for all users to be granted permissions after the cloud is created.

anyscale cloud edit

Usage

anyscale cloud edit [OPTIONS] [CLOUD_NAME]

Edit registered cloud resource on Anyscale. Only applicable for anyscale registered clouds.

Options

• --name/-n: Edit cloud by name.
• --cloud-id/--id: Edit cloud by id, alternative to cloud name.
• --aws-s3-id: New S3 bucket ID.
• --aws-efs-id: New EFS ID.
• --aws-efs-mount-target-ip: New EFS mount target IP.
• --memorydb-cluster-id: New AWS Memorydb cluster ID.
• --gcp-filestore-instance-id: New GCP filestore instance id.
• --gcp-filestore-location: New GCP filestore location.
• --gcp-cloud-storage-bucket-name: New GCP Cloud storage bucket name.
• --memorystore-instance-name: New Memorystore instance name for GCP clouds
• --functional-verify: Verify the cloud is functional. This will check that the cloud can launch workspace/service.
• --enable-auto-add-user/--disable-auto-add-user: If --enable-auto-add-user is specified for a cloud, all users in the organization will be added to the cloud by default. Note: There may be up to 30 sec delay for all users to be granted permissions after this feature is enabled.

Specifying --disable-auto-add-user will require that users are manually granted permissions to access the cloud. No existing cloud permissions are altered by specifying this flag.

anyscale cloud update

Usage

anyscale cloud update [OPTIONS] [CLOUD_NAME]

Update a managed cloud to the latest configuration. Only applicable for anyscale managed clouds.

Options

• --cloud-id/--id: Cloud id to update. Alternative to cloud name.
• --name/-n: Update configuration of cloud by name.
• --yes/-y: Skip asking for confirmation.
• --functional-verify: Verify the cloud is functional. This will check that the cloud can launch workspace/service.
• --enable-head-node-fault-tolerance: Whether to enable head node fault tolerance for services.
• --enable-auto-add-user/--disable-auto-add-user: If --enable-auto-add-user is specified for a cloud, all users in the organization will be added to the cloud by default. Note: There may be up to 30 sec delay for all users to be granted permissions after this feature is enabled.

Specifying --disable-auto-add-user will require that users are manually granted permissions to access the cloud. No existing cloud permissions are altered by specifying this flag.

anyscale cloud delete

Usage

anyscale cloud delete [OPTIONS] [CLOUD_NAME]

Delete a cloud.

Options

• --name/-n: Delete cloud by name.
• --cloud-id/--id: Cloud id to delete. Alternative to cloud name.
• --yes/-y: Don't ask for confirmation.

anyscale cloud verify

Usage

anyscale cloud verify [OPTIONS] [CLOUD_NAME]

Checks the healthiness of a cloud.

Options

• --name/-n: Verify cloud by name.
• --cloud-id/--id: Verify cloud by cloud id, alternative to cloud name.
• --functional-verify: Verify the cloud is functional. This will check that the cloud can launch workspace/service.
• --strict: Strict Verify. Treat warnings as failures.

anyscale cloud list

Usage

anyscale cloud list [OPTIONS]

List information about clouds in your Anyscale organization.

Options

• --name/-n: Name of cloud to get information about.
• --cloud-id/--id: Id of cloud to get information about.
• --max-items: Max items to show in list.

anyscale cloud config update

Usage

anyscale cloud config update [OPTIONS] [CLOUD_NAME]

Update the current configuration for a cloud.

Options

• --name/-n: Update configuration of cloud by name.
• --cloud-id/--id: Cloud id to get details about. Alternative to cloud name.
• --enable-log-ingestion/--disable-log-ingestion: If --enable-log-ingestion is specified for a cloud, it will enable the log viewing and querying UI features for the clusters on this cloud. This will enable easier debugging. The logs produced by the clusters will be sent from the data plane to the control plane. Anyscale does not share this data with any third party or use it for any purpose other than serving the log UI for the customer. The log will be stored at most 30 days.Please note by disable this feature again, Anyscale doesn't delete the logs that have already been ingested. Your clusters may incur extra data transfer cost from the cloud provider by enabling this feature.
• --spec-file: Provide a path to a specification file.

anyscale cloud set-default

Usage

anyscale cloud set-default [OPTIONS] [CLOUD_NAME]

Sets default cloud for your organization. This operation can only be performed by organization admins, and the default cloud must have organization level permissions.

Options

• --name/-n: Set cloud as default by name.
• --cloud-id/--id: Cloud id to set as default. Alternative to cloud name.

anyscale cloud add-collaborators

Usage

anyscale cloud add-collaborators [OPTIONS]

Add collaborators to the cloud.

Options

• --cloud/-c: Name of the cloud to add collaborators to.
• --users-file: Path to a YAML file containing a list of users to add to the cloud.

Examples

CLI

$ anyscale cloud add-collaborators --cloud cloud_name --users-file collaborators.yaml
(anyscale +1.3s) Successfully added 2 collaborators to cloud cloud_name.
$ cat collaborators.yaml
collaborators:
  - email: "test1@anyscale.com"
    permission_level: "write"
  - email: "test2@anyscale.com"
    permission_level: "readonly"

Cloud SDK

anyscale.cloud.add_collaborators

Batch add collaborators to a cloud.

Arguments

• cloud (str): The cloud to add users to.
• collaborators (List[CreateCloudCollaborator]): The list of collaborators to add to the cloud.

Returns: str

Examples

Python

import anyscale
from anyscale.cloud.models import CloudPermissionLevel, CreateCloudCollaborator

anyscale.cloud.add_collaborators(
    cloud="cloud_name",
    collaborators=[
        CreateCloudCollaborator(
            email="test1@anyscale.com",
            permission_level=CloudPermissionLevel.WRITE,
        ),
        CreateCloudCollaborator(
            email="test2@anyscale.com",
            permission_level=CloudPermissionLevel.READONLY,
        ),
    ],
)

Cloud Models

CloudPermissionLevel

An enumeration.

Values

• WRITE: Write permission level for the cloud
• READONLY: Readonly permission level for the cloud

CreateCloudCollaborator

User to be added as a collaborator to a cloud.

Fields

• email (str): Email of the user to be added as a collaborator.
• permission_level (CloudPermissionLevel): Permission level the added user should have for the cloud(one of: WRITE,READONLY

Python Methods

def to_dict(self) -> Dict[str, Any]
    """Return a dictionary representation of the model."""

Examples

Python

import anyscale
from anyscale.cloud.models import CloudPermissionLevel, CreateCloudCollaborator

create_cloud_collaborator = CreateCloudCollaborator(
   # Email of the user to be added as a collaborator
    email="test@anyscale.com",
    # Permission level for the user to the cloud (CloudPermissionLevel.WRITE, CloudPermissionLevel.READONLY)
    permission_level=CloudPermissionLevel.READONLY,
)

Cloud SDK Legacy

The AnyscaleSDK class must be constructed in order to make calls to the SDK. This class allows you to create an authenticated client in which to use the SDK.

Param	Type	Description
auth_token	Optional String	Authentication token used to verify you have permissions to access Anyscale. If not provided, permissions default to the credentials set for your current user. Credentials can be set by following the instructions on this page: https://console.anyscale.com/credentials

Example

from anyscale import AnyscaleSDK

sdk = AnyscaleSDK()

create_cloud Legacy

Limited support

This command is not actively maintained. Use with caution.

Creates a Cloud.

Parameters

Name	Type	Description	Notes
create_cloud	CreateCloud

Returns CloudResponse

delete_cloud Legacy

Limited support

This command is not actively maintained. Use with caution.

Deletes a Cloud. Will delete all clusters that are using this cloud. If any of those clusters are not terminated, this call will fail.

Parameters

Name	Type	Description	Notes
cloud_id	str	ID of the Cloud to delete.	Defaults to null

Returns void (empty response body)

get_cloud Legacy

Limited support

This command is not actively maintained. Use with caution.

Retrieves a Cloud.

Parameters

Name	Type	Description	Notes
cloud_id	str	ID of the Cloud to retrieve.	Defaults to null

Returns CloudResponse

get_default_cloud Legacy

Limited support

This command is not actively maintained. Use with caution.

Retrieves the default cloud for the logged in user. First prefers the default cloud set by the user's org, then the last used cloud.

Parameters This function does not have any parameters.

Returns CloudResponse

search_clouds Legacy

Limited support

This command is not actively maintained. Use with caution.

Searches for all accessible Clouds that satisfies the query.

Parameters

Name	Type	Description	Notes
clouds_query	CloudsQuery

Returns CloudListResponse

update_cloud Legacy

Limited support

This command is not actively maintained. Use with caution.

Updates a Cloud.

Parameters

Name	Type	Description	Notes
cloud_id	str	ID of the Cloud to update.	Defaults to null
update_cloud	UpdateCloud

Returns CloudResponse

Cloud Models Legacy

Cloud Legacy

Model used to create a Cloud.

Name	Type	Description	Notes
name	str	Name of this Cloud.	[default to null]
provider	CloudProviders	Provider of this Cloud (e.g. AWS).	[default to null]
compute_stack	ComputeStack	The compute stack associated with this cloud's primary cloud resource.	[optional] [default to null]
region	str	Region this Cloud is operating in. This value needs to be supported by this Cloud's provider. (e.g. us-west-2)	[default to null]
credentials	str	Credentials needed to interact with this Cloud.	[default to null]
config	CloudConfig	Additional configurable properties of this Cloud.	[optional] [default to null]
is_k8s	bool	Whether this cloud is managed via Kubernetes.	[optional] [default to false]
is_aioa	bool	Whether this cloud is an AIOA cloud.	[optional] [default to false]
availability_zones	List[str]	The availability zones that instances of this cloud are allowed to be launched in.	[optional] [default to null]
is_bring_your_own_resource	bool	Whether the resources of this cloud are provided by the customer.	[optional] [default to null]
is_private_cloud	bool	Whether this cloud is a private cloud.	[optional] [default to false]
cluster_management_stack_version	ClusterManagementStackVersions	The cluster management stack version of the cloud.	[optional] [default to null]
is_private_service_cloud	bool	Whether services created in this cloud should be private.	[optional] [default to null]
auto_add_user	bool	Whether all users in the organization should be automatically added to this cloud. This field is only relevant for organizations with cloud isolation enabled, because all users in the organization automatically have access to all clouds if cloud isolation is not enabled.	[optional] [default to false]
external_id	str	The trust policy external ID specified by the user for the cloud control plane role. It must start with the organization ID.	[optional] [default to null]
id	str	Server assigned unique identifier.	[default to null]
type	CloudTypes		[default to null]
creator_id	str	ID of the User who created this Cloud.	[default to null]
created_at	datetime	Time when this Cloud was created.	[default to null]
status	CloudStatus	The status of this cloud.	[optional] [default to null]
state	CloudState	The state of this cloud.	[optional] [default to null]
version	CloudVersion	The version of the cloud.	[optional] [default to null]
is_default	bool	Whether this cloud is the default cloud.	[default to null]
customer_aggregated_logs_config_id	str	the id of the customer aggregated logs config associated with this cloud.	[default to null]
additional_instance_types	List[UXInstance]	the list of instance types supported in the UI and through API (SDK/CLI).	[optional] [default to null]

CloudConfig Legacy

Name	Type	Description	Notes
max_stopped_instances	int	Maximum number of instances that can be retained for reuse after a Cluster has terminated. This may help Clusters start up faster, but stopped instances will accrue some costs. Defaults to 0, which means no instances will be retained for reuse. A value of -1 means all instances will be retained.	[optional] [default to 0]
vpc_peering_ip_range	str	VPC IP range for this Cloud.	[optional] [default to null]
vpc_peering_target_project_id	str	Project ID of the VPC to peer with.	[optional] [default to null]
vpc_peering_target_vpc_id	str	ID of the VPC to peer with.	[optional] [default to null]

CloudListResponse Legacy

A list response form the API. Contains a field "results" which has the contents of the response.

Name	Type	Description	Notes
results	List[Cloud]		[default to null]
metadata	ListResponseMetadata		[optional] [default to null]

CloudProviders Legacy

An enumeration.

Possible Values: ['AWS', 'GCP', 'CLOUDGATEWAY', 'PCP', 'GENERIC']

CloudResponse Legacy

A response from the API. Contains a field "result" which has the contents of the response.

Name	Type	Description	Notes
result	Cloud		[default to null]

CloudState Legacy

An enumeration.

Possible Values: ['CREATING', 'ACTIVE', 'VERIFICATION_FAILED', 'DELETING', 'DELETED', 'CLAIMED']

CloudStatus Legacy

An enumeration.

Possible Values: ['pending', 'ready']

CloudTypes Legacy

An enumeration.

Possible Values: ['PUBLIC', 'INTERNAL']

CloudVersion Legacy

An enumeration.

Possible Values: ['v1', 'v2']

CloudsQuery Legacy

Query object used to search Clouds.

Name	Type	Description	Notes
name	TextQuery	Filters ComputeTemplates by name. If this field is absent, no filtering is done.	[optional] [default to null]
paging	PageQuery	Pagination info.	[optional] [default to null]

CreateCloud Legacy

Model used to create a Cloud.

Name	Type	Description	Notes
name	str	Name of this Cloud.	[default to null]
provider	CloudProviders	Provider of this Cloud (e.g. AWS).	[default to null]
compute_stack	ComputeStack	The compute stack associated with this cloud's primary cloud resource.	[optional] [default to null]
region	str	Region this Cloud is operating in. This value needs to be supported by this Cloud's provider. (e.g. us-west-2)	[default to null]
credentials	str	Credentials needed to interact with this Cloud.	[default to null]
config	CloudConfig	Additional configurable properties of this Cloud.	[optional] [default to null]
is_k8s	bool	Whether this cloud is managed via Kubernetes.	[optional] [default to false]
is_aioa	bool	Whether this cloud is an AIOA cloud.	[optional] [default to false]
availability_zones	List[str]	The availability zones that instances of this cloud are allowed to be launched in.	[optional] [default to null]
is_bring_your_own_resource	bool	Whether the resources of this cloud are provided by the customer.	[optional] [default to null]
is_private_cloud	bool	Whether this cloud is a private cloud.	[optional] [default to false]
cluster_management_stack_version	ClusterManagementStackVersions	The cluster management stack version of the cloud.	[optional] [default to null]
is_private_service_cloud	bool	Whether services created in this cloud should be private.	[optional] [default to null]
auto_add_user	bool	Whether all users in the organization should be automatically added to this cloud. This field is only relevant for organizations with cloud isolation enabled, because all users in the organization automatically have access to all clouds if cloud isolation is not enabled.	[optional] [default to false]
external_id	str	The trust policy external ID specified by the user for the cloud control plane role. It must start with the organization ID.	[optional] [default to null]

UpdateCloud Legacy

Updateable fields for a Cloud. If a field is absent, it will not be updated.

Name	Type	Description	Notes
config	CloudConfig	Additional configurable properties of this Cloud.	[optional] [default to null]
auto_add_user	bool	Whether all users in the organization should be automatically added to this cloud. This field is only relevant for organizations with cloud isolation enabled, because all users in the organization automatically have access to all clouds if cloud isolation is not enabled.	[optional] [default to null]