For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.v2.registries.post(body: Multiregistry_create, requestConfiguration?: RequestConfiguration<object>): Promise<undefined | RegistriesPostResponse>

Description

To create your container registry, send a POST request to /v2/registries.

The name becomes part of the URL for images stored in the registry. For example, if your registry is called example, an image in it will have the URL registry.digitalocean.com/example/image:tag.

Parameters

name string required

Example: example

A globally unique name for the container registry. Must be lowercase and be composed only of numbers, letters and -, up to a limit of 63 characters.

Max length: 63

subscriptionTierSlug string optional

The slug of the subscription tier to sign up for. Valid values can be retrieved using the options endpoint.

One of: starter, basic, professional

region string optional

Slug of the region where registry data is stored. When not provided, a region will be selected.

One of: nyc3, sfo3, sfo2, ams3, sgp1, fra1, blr1, syd1

Request Sample

import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.v2.registries.post({
    name: "example",
    subscriptionTierSlug: "basic",
    region: "fra1",
});

Response Example

{
  "registry": {
    "name": "example",
    "created_at": "2020-03-21T16:02:37Z",
    "region": "fra1",
    "storage_usage_bytes": 29393920,
    "storage_usage_bytes_updated_at": "2020-11-04T21:39:49.530562231Z"
  }
}

More Information

See /v2/registries in the API reference for additional detail on responses, headers, parameters, and more.