Cloud Providers /

Create docker registry

Creates a new docker registry.

Required permission

Account > Cloud > Registries > Create

Request body

{object}

name
string required
The name of the cloud provider registry.
min length
3
max length
39
pattern
^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
description
string
The description of the integration.
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
uid
string
Unique id of the registry.
provider
string required
Cloud provider to be used for the selected resource
one of
aws, azure, civo, gcp, oci, byok
region
string required
integrationId
string
Integration to use for this registry.
pattern
^((org|team)\/)?[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
restrictions
{object}
BYOC restrictions configuration for controlling team access

enabled
boolean required
Enable or disable BYOC restrictions for this entity
teams
[array]
List of teams that have access to this BYOC cluster

{object}

teamId
string required
The ID of the team that has access to this BYOC cluster

updatedAt
string
time of update
createdAt
string
time of creation

Response body

{object}
Response object.

data
{object} required
Result data.

name
string required
The name of the cloud provider registry.
min length
3
max length
39
pattern
^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$
description
string
The description of the integration.
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
uid
string
Unique id of the registry.
provider
string required
Cloud provider to be used for the selected resource
one of
aws, azure, civo, gcp, oci, byok
region
string required
integrationId
string
Integration to use for this registry.
pattern
^((org|team)\/)?[a-zA-Z](-?[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$
restrictions
{object}
BYOC restrictions configuration for controlling team access

enabled
boolean required
Enable or disable BYOC restrictions for this entity
teams
[array]
List of teams that have access to this BYOC cluster

{object}

teamId
string required
The ID of the team that has access to this BYOC cluster

updatedAt
string
time of update
createdAt
string
time of creation

API

CLI

JS Client

POST /v1/cloud-providers/docker-registries

Example request

Request body

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"name":"Example Registry","description":"This is a new cloud provider registry.","uid":"nf-n7xyvdn4","provider":"gcp","region":"eu-west-1","integrationId":"gcp-integration"}' \
  https://api.northflank.com/v1/cloud-providers/docker-registries

Example response

200 OK

Details about the created docker registry.

JSON

{
  "data": {
    "name": "Example Registry",
    "description": "This is a new cloud provider registry.",
    "uid": "nf-n7xyvdn4",
    "provider": "gcp",
    "region": "eu-west-1",
    "integrationId": "gcp-integration"
  }
}