subscriptions

Creates, updates, deletes, gets or lists a subscriptions resource.

Overview

Name	subscriptions
Type	Resource
Id	digitalocean.container_registry.subscriptions

Fields

The following fields are returned by SELECT queries:

registries_get_subscription

The response will be a JSON object with a key called subscription containing information about your subscription.

Name	Datatype	Description
created_at	string (date-time)	The time at which the subscription was created. (example: 2020-01-23T21:19:12Z)
tier	object
updated_at	string (date-time)	The time at which the subscription was last updated. (example: 2020-11-05T15:53:24Z)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
registries_get_subscription	select			A subscription is automatically created when you configure your container registry. To get information about your subscription, send a GET request to /v2/registries/subscription. It is similar to GET /v2/registry/subscription.
registries_update_subscription	insert			After creating your registry, you can switch to a different subscription tier to better suit your needs. To do this, send a POST request to /v2/registries/subscription. It is similar to POST /v2/registry/subscription.
registry_get_subscription_legacy	exec			Note: This endpoint is deprecated. Please use the /v2/registries endpoint instead. A subscription is automatically created when you configure your container registry. To get information about your subscription, send a GET request to /v2/registry/subscription.
registry_update_subscription_legacy	exec			Note: This endpoint is deprecated. Please use the /v2/registries endpoint instead. After creating your registry, you can switch to a different subscription tier to better suit your needs. To do this, send a POST request to /v2/registry/subscription.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description

SELECT examples

registries_get_subscription

A subscription is automatically created when you configure your container registry. To get information about your subscription, send a GET request to /v2/registries/subscription. It is similar to GET /v2/registry/subscription.

SELECT
created_at,
tier,
updated_at
FROM digitalocean.container_registry.subscriptions
;

INSERT examples

registries_update_subscription

After creating your registry, you can switch to a different subscription tier to better suit your needs. To do this, send a POST request to /v2/registries/subscription. It is similar to POST /v2/registry/subscription.

INSERT INTO digitalocean.container_registry.subscriptions (
tier_slug
)
SELECT 
'{{ tier_slug }}'
RETURNING
subscription
;

Manifest

# Description fields are for documentation purposes
- name: subscriptions
props:
  - name: tier_slug
    value: "{{ tier_slug }}"
    description: |
      The slug of the subscription tier to sign up for.
    valid_values: ['starter', 'basic', 'professional']

Lifecycle Methods

registry_get_subscription_legacy

Note: This endpoint is deprecated. Please use the /v2/registries endpoint instead.

A subscription is automatically created when you configure your
container registry. To get information about your subscription, send a GET
request to /v2/registry/subscription.

EXEC digitalocean.container_registry.subscriptions.registry_get_subscription_legacy 

;

registry_update_subscription_legacy

Note: This endpoint is deprecated. Please use the /v2/registries endpoint instead.

After creating your registry, you can switch to a different
subscription tier to better suit your needs. To do this, send a POST request
to /v2/registry/subscription.

EXEC digitalocean.container_registry.subscriptions.registry_update_subscription_legacy 
@@json=
'{
"tier_slug": "{{ tier_slug }}"
}'
;