Subscription

class oci.ons.models.Subscription(**kwargs)

Bases: object

The subscription’s configuration. For general information about subscriptions, see Notifications Overview.

Attributes:

LIFECYCLE_STATE_ACTIVE

A constant which can be used with the lifecycle_state property of a Subscription.

LIFECYCLE_STATE_DELETED

A constant which can be used with the lifecycle_state property of a Subscription.

LIFECYCLE_STATE_PENDING

A constant which can be used with the lifecycle_state property of a Subscription.

compartment_id

[Required] Gets the compartment_id of this Subscription.

created_time

Gets the created_time of this Subscription.

defined_tags

Gets the defined_tags of this Subscription.

deliver_policy

Gets the deliver_policy of this Subscription.

endpoint

[Required] Gets the endpoint of this Subscription.

etag

Gets the etag of this Subscription.

freeform_tags

Gets the freeform_tags of this Subscription.

id

[Required] Gets the id of this Subscription.

lifecycle_state

[Required] Gets the lifecycle_state of this Subscription.

protocol

[Required] Gets the protocol of this Subscription.

topic_id

[Required] Gets the topic_id of this Subscription.

Methods:

__init__(**kwargs)

Initializes a new Subscription object with values from keyword arguments.

LIFECYCLE_STATE_ACTIVE = 'ACTIVE'

A constant which can be used with the lifecycle_state property of a Subscription. This constant has a value of “ACTIVE”

LIFECYCLE_STATE_DELETED = 'DELETED'

A constant which can be used with the lifecycle_state property of a Subscription. This constant has a value of “DELETED”

LIFECYCLE_STATE_PENDING = 'PENDING'

A constant which can be used with the lifecycle_state property of a Subscription. This constant has a value of “PENDING”

__init__(**kwargs)

Initializes a new Subscription object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters
  • id (str) – The value to assign to the id property of this Subscription.

  • topic_id (str) – The value to assign to the topic_id property of this Subscription.

  • protocol (str) – The value to assign to the protocol property of this Subscription.

  • endpoint (str) – The value to assign to the endpoint property of this Subscription.

  • lifecycle_state (str) – The value to assign to the lifecycle_state property of this Subscription. Allowed values for this property are: “PENDING”, “ACTIVE”, “DELETED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

  • compartment_id (str) – The value to assign to the compartment_id property of this Subscription.

  • created_time (int) – The value to assign to the created_time property of this Subscription.

  • deliver_policy (str) – The value to assign to the deliver_policy property of this Subscription.

  • etag (str) – The value to assign to the etag property of this Subscription.

  • freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this Subscription.

  • defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this Subscription.

property compartment_id

[Required] Gets the compartment_id of this Subscription. The OCID of the compartment for the subscription.

Returns

The compartment_id of this Subscription.

Return type

str

property created_time

Gets the created_time of this Subscription. The time when this suscription was created.

Returns

The created_time of this Subscription.

Return type

int

property defined_tags

Gets the defined_tags of this Subscription. Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

Example: {“Operations”: {“CostCenter”: “42”}}

Returns

The defined_tags of this Subscription.

Return type

dict(str, dict(str, object))

property deliver_policy

Gets the deliver_policy of this Subscription. The delivery policy of the subscription. Stored as a JSON string.

Returns

The deliver_policy of this Subscription.

Return type

str

property endpoint

[Required] Gets the endpoint of this Subscription. A locator that corresponds to the subscription protocol. For example, an email address for a subscription that uses the EMAIL protocol, or a URL for a subscription that uses an HTTP-based protocol.

Returns

The endpoint of this Subscription.

Return type

str

property etag

Gets the etag of this Subscription. For optimistic concurrency control. See if-match.

Returns

The etag of this Subscription.

Return type

str

property freeform_tags

Gets the freeform_tags of this Subscription. Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.

Example: {“Department”: “Finance”}

Returns

The freeform_tags of this Subscription.

Return type

dict(str, str)

property id

[Required] Gets the id of this Subscription. The OCID of the subscription.

Returns

The id of this Subscription.

Return type

str

property lifecycle_state

[Required] Gets the lifecycle_state of this Subscription. The lifecycle state of the subscription. The status of a new subscription is PENDING; when confirmed, the subscription status changes to ACTIVE.

Allowed values for this property are: “PENDING”, “ACTIVE”, “DELETED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns

The lifecycle_state of this Subscription.

Return type

str

property protocol

[Required] Gets the protocol of this Subscription. The protocol used for the subscription.

Allowed values:
  • CUSTOM_HTTPS

  • EMAIL

  • HTTPS (deprecated; for PagerDuty endpoints, use PAGERDUTY)

  • ORACLE_FUNCTIONS

  • PAGERDUTY

  • SLACK

  • SMS

For information about subscription protocols, see To create a subscription.

Returns

The protocol of this Subscription.

Return type

str

property topic_id

[Required] Gets the topic_id of this Subscription. The OCID of the associated topic.

Returns

The topic_id of this Subscription.

Return type

str