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 and exists for backward compatibility.
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 and exists for backward compatibility.
registry_get_subscription_legacy	exec			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			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 and exists for backward compatibility.

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 and exists for backward compatibility.

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

Manifest

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

Lifecycle Methods

registry_get_subscription_legacy

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

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 }}"
}';