CcdOffer¶
- class oci.ccd_offers.models.CcdOffer(**kwargs)¶
Bases:
objectThe created CCD offer details.
Attributes:
A constant which can be used with the customer_segment property of a CcdOffer.
A constant which can be used with the customer_segment property of a CcdOffer.
A constant which can be used with the lifecycle_details property of a CcdOffer.
A constant which can be used with the lifecycle_details property of a CcdOffer.
A constant which can be used with the lifecycle_details property of a CcdOffer.
A constant which can be used with the lifecycle_details property of a CcdOffer.
A constant which can be used with the lifecycle_state property of a CcdOffer.
A constant which can be used with the reclaim_term_unit property of a CcdOffer.
A constant which can be used with the source_type property of a CcdOffer.
A constant which can be used with the source_type property of a CcdOffer.
A constant which can be used with the source_type property of a CcdOffer.
A constant which can be used with the source_type property of a CcdOffer.
A constant which can be used with the type_of_offer property of a CcdOffer.
A constant which can be used with the type_of_offer property of a CcdOffer.
A constant which can be used with the type_of_offer property of a CcdOffer.
A constant which can be used with the type_of_offer property of a CcdOffer.
A constant which can be used with the type_of_offer property of a CcdOffer.
A constant which can be used with the unit property of a CcdOffer.
A constant which can be used with the unit property of a CcdOffer.
A constant which can be used with the unit property of a CcdOffer.
A constant which can be used with the unit property of a CcdOffer.
Gets the bundle_skus of this CcdOffer.
Gets the compartment_id of this CcdOffer.
Gets the created_by of this CcdOffer.
Gets the currency_code of this CcdOffer.
Gets the customer_segment of this CcdOffer.
Gets the defined_tags of this CcdOffer.
[Required] Gets the discount_pct of this CcdOffer.
[Required] Gets the display_name of this CcdOffer.
Gets the external_price_of_sku of this CcdOffer.
Gets the freeform_tags of this CcdOffer.
[Required] Gets the id of this CcdOffer.
Gets the is_filler_usage_enable of this CcdOffer.
Gets the last_updated_by of this CcdOffer.
Gets the lifecycle_details of this CcdOffer.
Gets the lifecycle_state of this CcdOffer.
Gets the list_price of this CcdOffer.
Gets the max_quantity of this CcdOffer.
[Required] Gets the min_quantity of this CcdOffer.
Gets the offer_restriction of this CcdOffer.
Gets the order_document_number of this CcdOffer.
Gets the reclaim_term of this CcdOffer.
Gets the reclaim_term_unit of this CcdOffer.
Gets the reporting_region of this CcdOffer.
[Required] Gets the sku of this CcdOffer.
[Required] Gets the sku_display_name of this CcdOffer.
[Required] Gets the sku_metric of this CcdOffer.
Gets the source_type of this CcdOffer.
Gets the subscription_id of this CcdOffer.
Gets the system_tags of this CcdOffer.
[Required] Gets the term of this CcdOffer.
Gets the time_ccd_offer_ends of this CcdOffer.
Gets the time_ccd_offer_starts of this CcdOffer.
Gets the time_created of this CcdOffer.
Gets the time_terminated of this CcdOffer.
Gets the time_updated of this CcdOffer.
Gets the type_of_offer of this CcdOffer.
Gets the unit of this CcdOffer.
Methods:
__init__(**kwargs)Initializes a new CcdOffer object with values from keyword arguments.
- CUSTOMER_SEGMENT_EXTERNAL = 'EXTERNAL'¶
A constant which can be used with the customer_segment property of a CcdOffer. This constant has a value of “EXTERNAL”
- CUSTOMER_SEGMENT_INTERNAL = 'INTERNAL'¶
A constant which can be used with the customer_segment property of a CcdOffer. This constant has a value of “INTERNAL”
- LIFECYCLE_DETAILS_CANCELED = 'CANCELED'¶
A constant which can be used with the lifecycle_details property of a CcdOffer. This constant has a value of “CANCELED”
- LIFECYCLE_DETAILS_CURRENT = 'CURRENT'¶
A constant which can be used with the lifecycle_details property of a CcdOffer. This constant has a value of “CURRENT”
- LIFECYCLE_DETAILS_ENDED = 'ENDED'¶
A constant which can be used with the lifecycle_details property of a CcdOffer. This constant has a value of “ENDED”
- LIFECYCLE_DETAILS_SCHEDULED = 'SCHEDULED'¶
A constant which can be used with the lifecycle_details property of a CcdOffer. This constant has a value of “SCHEDULED”
- LIFECYCLE_STATE_ACTIVE = 'ACTIVE'¶
A constant which can be used with the lifecycle_state property of a CcdOffer. This constant has a value of “ACTIVE”
- RECLAIM_TERM_UNIT_DAYS = 'DAYS'¶
A constant which can be used with the reclaim_term_unit property of a CcdOffer. This constant has a value of “DAYS”
- SOURCE_TYPE_CONTRACT_COMMITMENT = 'CONTRACT_COMMITMENT'¶
A constant which can be used with the source_type property of a CcdOffer. This constant has a value of “CONTRACT_COMMITMENT”
- SOURCE_TYPE_CONTRACT_OFFER = 'CONTRACT_OFFER'¶
A constant which can be used with the source_type property of a CcdOffer. This constant has a value of “CONTRACT_OFFER”
- SOURCE_TYPE_FLEX = 'FLEX'¶
A constant which can be used with the source_type property of a CcdOffer. This constant has a value of “FLEX”
- SOURCE_TYPE_OCI_GENERATED = 'OCI_GENERATED'¶
A constant which can be used with the source_type property of a CcdOffer. This constant has a value of “OCI_GENERATED”
- TYPE_OF_OFFER_CONTRACTUAL = 'CONTRACTUAL'¶
A constant which can be used with the type_of_offer property of a CcdOffer. This constant has a value of “CONTRACTUAL”
- TYPE_OF_OFFER_CUSTOM = 'CUSTOM'¶
A constant which can be used with the type_of_offer property of a CcdOffer. This constant has a value of “CUSTOM”
- TYPE_OF_OFFER_FLEX = 'FLEX'¶
A constant which can be used with the type_of_offer property of a CcdOffer. This constant has a value of “FLEX”
- TYPE_OF_OFFER_PRIVATE = 'PRIVATE'¶
A constant which can be used with the type_of_offer property of a CcdOffer. This constant has a value of “PRIVATE”
- TYPE_OF_OFFER_STANDARD = 'STANDARD'¶
A constant which can be used with the type_of_offer property of a CcdOffer. This constant has a value of “STANDARD”
- UNIT_DAYS = 'DAYS'¶
A constant which can be used with the unit property of a CcdOffer. This constant has a value of “DAYS”
- UNIT_HOURS = 'HOURS'¶
A constant which can be used with the unit property of a CcdOffer. This constant has a value of “HOURS”
- UNIT_MONTHS = 'MONTHS'¶
A constant which can be used with the unit property of a CcdOffer. This constant has a value of “MONTHS”
- UNIT_YEARS = 'YEARS'¶
A constant which can be used with the unit property of a CcdOffer. This constant has a value of “YEARS”
- __init__(**kwargs)¶
Initializes a new CcdOffer 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 CcdOffer.
display_name (str) – The value to assign to the display_name property of this CcdOffer.
type_of_offer (str) – The value to assign to the type_of_offer property of this CcdOffer. Allowed values for this property are: “STANDARD”, “CUSTOM”, “PRIVATE”, “CONTRACTUAL”, “FLEX”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
source_type (str) – The value to assign to the source_type property of this CcdOffer. Allowed values for this property are: “CONTRACT_COMMITMENT”, “CONTRACT_OFFER”, “FLEX”, “OCI_GENERATED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
reclaim_term (int) – The value to assign to the reclaim_term property of this CcdOffer.
reclaim_term_unit (str) – The value to assign to the reclaim_term_unit property of this CcdOffer. Allowed values for this property are: “DAYS”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
last_updated_by (str) – The value to assign to the last_updated_by property of this CcdOffer.
created_by (str) – The value to assign to the created_by property of this CcdOffer.
order_document_number (str) – The value to assign to the order_document_number property of this CcdOffer.
customer_segment (str) – The value to assign to the customer_segment property of this CcdOffer. Allowed values for this property are: “INTERNAL”, “EXTERNAL”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
is_filler_usage_enable (bool) – The value to assign to the is_filler_usage_enable property of this CcdOffer.
reporting_region (str) – The value to assign to the reporting_region property of this CcdOffer.
sku (str) – The value to assign to the sku property of this CcdOffer.
sku_display_name (str) – The value to assign to the sku_display_name property of this CcdOffer.
sku_metric (str) – The value to assign to the sku_metric property of this CcdOffer.
min_quantity (int) – The value to assign to the min_quantity property of this CcdOffer.
max_quantity (int) – The value to assign to the max_quantity property of this CcdOffer.
term (int) – The value to assign to the term property of this CcdOffer.
unit (str) – The value to assign to the unit property of this CcdOffer. Allowed values for this property are: “MONTHS”, “YEARS”, “DAYS”, “HOURS”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
discount_pct (str) – The value to assign to the discount_pct property of this CcdOffer.
external_price_of_sku (list[oci.ccd_offers.models.SkuExternalPriceModel]) – The value to assign to the external_price_of_sku property of this CcdOffer.
offer_restriction (oci.ccd_offers.models.OfferRestriction) – The value to assign to the offer_restriction property of this CcdOffer.
bundle_skus (list[oci.ccd_offers.models.BundleSku]) – The value to assign to the bundle_skus property of this CcdOffer.
lifecycle_state (str) – The value to assign to the lifecycle_state property of this CcdOffer. Allowed values for this property are: “ACTIVE”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
lifecycle_details (str) – The value to assign to the lifecycle_details property of this CcdOffer. Allowed values for this property are: “SCHEDULED”, “CURRENT”, “CANCELED”, “ENDED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
time_created (datetime) – The value to assign to the time_created property of this CcdOffer.
time_terminated (datetime) – The value to assign to the time_terminated property of this CcdOffer.
time_updated (datetime) – The value to assign to the time_updated property of this CcdOffer.
freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this CcdOffer.
defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this CcdOffer.
system_tags (dict(str, dict(str, object))) – The value to assign to the system_tags property of this CcdOffer.
time_ccd_offer_starts (datetime) – The value to assign to the time_ccd_offer_starts property of this CcdOffer.
time_ccd_offer_ends (datetime) – The value to assign to the time_ccd_offer_ends property of this CcdOffer.
currency_code (str) – The value to assign to the currency_code property of this CcdOffer.
list_price (str) – The value to assign to the list_price property of this CcdOffer.
subscription_id (str) – The value to assign to the subscription_id property of this CcdOffer.
compartment_id (str) – The value to assign to the compartment_id property of this CcdOffer.
- property bundle_skus¶
Gets the bundle_skus of this CcdOffer. The polymorphic bundled SKU definitions. Every bundled SKU in an offer must use the same quantityRule; don’t mix FIXED_RATIO and CUSTOMER_SELECTED bundled SKUs in one offer. An offer can contain at most five SKUs in total, including the primary SKU.
- Returns
The bundle_skus of this CcdOffer.
- Return type
- property compartment_id¶
Gets the compartment_id of this CcdOffer. The root compartment OCID of the customer’s tenancy if offer is dedicated to a particular customer only.
- Returns
The compartment_id of this CcdOffer.
- Return type
str
- property created_by¶
Gets the created_by of this CcdOffer. Entity/User who created the ccdOffer.
- Returns
The created_by of this CcdOffer.
- Return type
str
- property currency_code¶
Gets the currency_code of this CcdOffer. Currency code of listPrice associated with primary product/sku. This will be always null. Please refer externalPriceOfSku to know product/sku’s associated list price in its currency code.
- Returns
The currency_code of this CcdOffer.
- Return type
str
- property customer_segment¶
Gets the customer_segment of this CcdOffer. The targeted customer segment.
Allowed values for this property are: “INTERNAL”, “EXTERNAL”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The customer_segment of this CcdOffer.
- Return type
str
- property defined_tags¶
Gets the defined_tags of this CcdOffer. 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 CcdOffer.
- Return type
dict(str, dict(str, object))
- property discount_pct¶
[Required] Gets the discount_pct of this CcdOffer. The discount percentage applicable to the CCD offer, represented as a decimal string from 0 through 100 inclusive.
- Returns
The discount_pct of this CcdOffer.
- Return type
str
- property display_name¶
[Required] Gets the display_name of this CcdOffer. The CCD offer name.
- Returns
The display_name of this CcdOffer.
- Return type
str
- property external_price_of_sku¶
Gets the external_price_of_sku of this CcdOffer. The SKU list price in all currency codes.
- Returns
The external_price_of_sku of this CcdOffer.
- Return type
- property freeform_tags¶
Gets the freeform_tags of this CcdOffer. 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 CcdOffer.
- Return type
dict(str, str)
- property id¶
[Required] Gets the id of this CcdOffer. The CCD offer OCID.
- Returns
The id of this CcdOffer.
- Return type
str
- property is_filler_usage_enable¶
Gets the is_filler_usage_enable of this CcdOffer. Enable or disable filler usage if the customer usage quantity is below the minimum quantity, and you want metering to fill in usages to meet the minimum quantity.
- Returns
The is_filler_usage_enable of this CcdOffer.
- Return type
bool
- property last_updated_by¶
Gets the last_updated_by of this CcdOffer. Entity/User who lastly updated the ccdOffer.
- Returns
The last_updated_by of this CcdOffer.
- Return type
str
- property lifecycle_details¶
Gets the lifecycle_details of this CcdOffer. The CCD offer’s detailed current state. The state value is determined by timeCcdOfferStarts, timeCcdOfferEnds, and timeTerminated with respect to the current time.
Allowed values for this property are: “SCHEDULED”, “CURRENT”, “CANCELED”, “ENDED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The lifecycle_details of this CcdOffer.
- Return type
str
- property lifecycle_state¶
Gets the lifecycle_state of this CcdOffer. Always defaults to Active. For the accurate resource state, refer to the lifecycleDetails property value.
Allowed values for this property are: “ACTIVE”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The lifecycle_state of this CcdOffer.
- Return type
str
- property list_price¶
Gets the list_price of this CcdOffer. ListPrice of a sku. Please refer externalPriceOfSku to know product/sku’s associated list price in its currency code.
- Returns
The list_price of this CcdOffer.
- Return type
str
- property max_quantity¶
Gets the max_quantity of this CcdOffer. The maximum quantity of the primary SKU committed to the CCD offer. For FLEX offers if provided, it must equal minQuantity.
- Returns
The max_quantity of this CcdOffer.
- Return type
int
- property min_quantity¶
[Required] Gets the min_quantity of this CcdOffer. The minimum quantity of the primary SKU committed to the CCD offer. For FLEX offers, minQuantity and maxQuantity must both be equal if maxQuantity provided.
- Returns
The min_quantity of this CcdOffer.
- Return type
int
- property offer_restriction¶
Gets the offer_restriction of this CcdOffer.
- Returns
The offer_restriction of this CcdOffer.
- Return type
- property order_document_number¶
Gets the order_document_number of this CcdOffer. Sales order document number.
- Returns
The order_document_number of this CcdOffer.
- Return type
str
- property reclaim_term¶
Gets the reclaim_term of this CcdOffer. The reclaim term for an offer, measured in reclaimTermUnit.
- Returns
The reclaim_term of this CcdOffer.
- Return type
int
- property reclaim_term_unit¶
Gets the reclaim_term_unit of this CcdOffer. The unit used to measure reclaimTerm.
Allowed values for this property are: “DAYS”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The reclaim_term_unit of this CcdOffer.
- Return type
str
- property reporting_region¶
Gets the reporting_region of this CcdOffer. Defines where the filler usage is reported
- Returns
The reporting_region of this CcdOffer.
- Return type
str
- property sku¶
[Required] Gets the sku of this CcdOffer. The SKU part number (prefaced with “B”) the CCD is associated with.
- Returns
The sku of this CcdOffer.
- Return type
str
- property sku_display_name¶
[Required] Gets the sku_display_name of this CcdOffer. The canonical SKU display name.
- Returns
The sku_display_name of this CcdOffer.
- Return type
str
- property sku_metric¶
[Required] Gets the sku_metric of this CcdOffer. The canonical billing metric.
- Returns
The sku_metric of this CcdOffer.
- Return type
str
- property source_type¶
Gets the source_type of this CcdOffer. The commercial workflow that created the CCD offer/commitment. This value is immutable.
Allowed values for this property are: “CONTRACT_COMMITMENT”, “CONTRACT_OFFER”, “FLEX”, “OCI_GENERATED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The source_type of this CcdOffer.
- Return type
str
- property subscription_id¶
Gets the subscription_id of this CcdOffer. The subscription OCID if a this is dedicated CCD offer for a customer.
- Returns
The subscription_id of this CcdOffer.
- Return type
str
- property system_tags¶
Gets the system_tags of this CcdOffer. System tags for this resource. Each key is predefined and scoped to a namespace.
Example: {“orcl-cloud”: {“free-tier-retained”: “true”}}
- Returns
The system_tags of this CcdOffer.
- Return type
dict(str, dict(str, object))
- property term¶
[Required] Gets the term of this CcdOffer. The number of terms the offer is applicable to.
- Returns
The term of this CcdOffer.
- Return type
int
- property time_ccd_offer_ends¶
Gets the time_ccd_offer_ends of this CcdOffer. The inclusive time when the CCD offer is no longer in effect, and must be after timeCcdOfferStarts. The format is defined by RFC 3339.
- Returns
The time_ccd_offer_ends of this CcdOffer.
- Return type
datetime
- property time_ccd_offer_starts¶
Gets the time_ccd_offer_starts of this CcdOffer. The inclusive date the CCD offer will be effective. The format is defined by RFC 3339.
- Returns
The time_ccd_offer_starts of this CcdOffer.
- Return type
datetime
- property time_created¶
Gets the time_created of this CcdOffer. Date and time the CCD was created. The format is defined by RFC 3339. Example: 2022-01-25T21:10:29.600Z
- Returns
The time_created of this CcdOffer.
- Return type
datetime
- property time_terminated¶
Gets the time_terminated of this CcdOffer. Date and time the CCD was terminated. The format is defined by RFC 3339. Example: 2022-01-25T21:10:29.600Z
- Returns
The time_terminated of this CcdOffer.
- Return type
datetime
- property time_updated¶
Gets the time_updated of this CcdOffer. Date and time the CCD was updated lastly. The format is defined by RFC 3339. Example: 2025-01-25T21:10:29.600Z
- Returns
The time_updated of this CcdOffer.
- Return type
datetime
- property type_of_offer¶
Gets the type_of_offer of this CcdOffer. The CCD offer type.
Allowed values for this property are: “STANDARD”, “CUSTOM”, “PRIVATE”, “CONTRACTUAL”, “FLEX”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The type_of_offer of this CcdOffer.
- Return type
str
- property unit¶
Gets the unit of this CcdOffer. The term units.
Allowed values for this property are: “MONTHS”, “YEARS”, “DAYS”, “HOURS”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The unit of this CcdOffer.
- Return type
str