Documentation
¶
Index ¶
- type CreateQuotaDetails
- type CreateQuotaRequest
- type CreateQuotaResponse
- type DeleteQuotaRequest
- type DeleteQuotaResponse
- type GetQuotaRequest
- type GetQuotaResponse
- type ListQuotasLifecycleStateEnum
- type ListQuotasRequest
- type ListQuotasResponse
- type ListQuotasSortByEnum
- type ListQuotasSortOrderEnum
- type Quota
- type QuotaLifecycleStateEnum
- type QuotaSummary
- type QuotaSummaryLifecycleStateEnum
- type QuotasClient
- func (client *QuotasClient) ConfigurationProvider() *common.ConfigurationProvider
- func (client QuotasClient) CreateQuota(ctx context.Context, request CreateQuotaRequest) (response CreateQuotaResponse, err error)
- func (client QuotasClient) DeleteQuota(ctx context.Context, request DeleteQuotaRequest) (response DeleteQuotaResponse, err error)
- func (client QuotasClient) GetQuota(ctx context.Context, request GetQuotaRequest) (response GetQuotaResponse, err error)
- func (client QuotasClient) ListQuotas(ctx context.Context, request ListQuotasRequest) (response ListQuotasResponse, err error)
- func (client *QuotasClient) SetRegion(region string)
- func (client QuotasClient) UpdateQuota(ctx context.Context, request UpdateQuotaRequest) (response UpdateQuotaResponse, err error)
- type UpdateQuotaDetails
- type UpdateQuotaRequest
- type UpdateQuotaResponse
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type CreateQuotaDetails ¶
type CreateQuotaDetails struct {
// The OCID of the compartment containing the resource this quota applies to.
CompartmentId *string `mandatory:"true" json:"compartmentId"`
// The description you assign to the quota.
Description *string `mandatory:"true" json:"description"`
// The name you assign to the quota during creation. The name must be unique across all quotas
// in the tenancy and cannot be changed.
Name *string `mandatory:"true" json:"name"`
// An array of quota statements written in the declarative language.
Statements []string `mandatory:"true" json:"statements"`
// 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 (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Department": "Finance"}`
FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
// Defined tags for this resource. Each key is predefined and scoped to a namespace.
// For more information, see Resource Tags (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Operations": {"CostCenter": "42"}}`
DefinedTags map[string]map[string]interface{} `mandatory:"false" json:"definedTags"`
}
CreateQuotaDetails Request object for create quota operation.
func (CreateQuotaDetails) String ¶
func (m CreateQuotaDetails) String() string
type CreateQuotaRequest ¶
type CreateQuotaRequest struct {
// Request object for creating a new quota.
CreateQuotaDetails `contributesTo:"body"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`
// A token that uniquely identifies a request so it can be retried in case of a timeout or
// server error without risk of executing that same action again. Retry tokens expire after 24
// hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
// has been deleted and purged from the system, then a retry of the original creation request
// may be rejected).
OpcRetryToken *string `mandatory:"false" contributesTo:"header" name:"opc-retry-token"`
// Metadata about the request. This information will not be transmitted to the service, but
// represents information that the SDK will consume to drive retry behavior.
RequestMetadata common.RequestMetadata
}
CreateQuotaRequest wrapper for the CreateQuota operation
func (CreateQuotaRequest) HTTPRequest ¶
func (request CreateQuotaRequest) HTTPRequest(method, path string) (http.Request, error)
HTTPRequest implements the OCIRequest interface
func (CreateQuotaRequest) RetryPolicy ¶
func (request CreateQuotaRequest) RetryPolicy() *common.RetryPolicy
RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.
func (CreateQuotaRequest) String ¶
func (request CreateQuotaRequest) String() string
type CreateQuotaResponse ¶
type CreateQuotaResponse struct {
// The underlying http response
RawResponse *http.Response
// The Quota instance
Quota `presentIn:"body"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
// For optimistic concurrency control. See `if-match`.
Etag *string `presentIn:"header" name:"etag"`
}
CreateQuotaResponse wrapper for the CreateQuota operation
func (CreateQuotaResponse) HTTPResponse ¶
func (response CreateQuotaResponse) HTTPResponse() *http.Response
HTTPResponse implements the OCIResponse interface
func (CreateQuotaResponse) String ¶
func (response CreateQuotaResponse) String() string
type DeleteQuotaRequest ¶
type DeleteQuotaRequest struct {
// The OCID of the quota.
QuotaId *string `mandatory:"true" contributesTo:"path" name:"quotaId"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`
// For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
// parameter to the value of the etag from a previous GET or POST response for that resource. The resource
// will be updated or deleted only if the etag you provide matches the resource's current etag value.
IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`
// Metadata about the request. This information will not be transmitted to the service, but
// represents information that the SDK will consume to drive retry behavior.
RequestMetadata common.RequestMetadata
}
DeleteQuotaRequest wrapper for the DeleteQuota operation
func (DeleteQuotaRequest) HTTPRequest ¶
func (request DeleteQuotaRequest) HTTPRequest(method, path string) (http.Request, error)
HTTPRequest implements the OCIRequest interface
func (DeleteQuotaRequest) RetryPolicy ¶
func (request DeleteQuotaRequest) RetryPolicy() *common.RetryPolicy
RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.
func (DeleteQuotaRequest) String ¶
func (request DeleteQuotaRequest) String() string
type DeleteQuotaResponse ¶
type DeleteQuotaResponse struct {
// The underlying http response
RawResponse *http.Response
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}
DeleteQuotaResponse wrapper for the DeleteQuota operation
func (DeleteQuotaResponse) HTTPResponse ¶
func (response DeleteQuotaResponse) HTTPResponse() *http.Response
HTTPResponse implements the OCIResponse interface
func (DeleteQuotaResponse) String ¶
func (response DeleteQuotaResponse) String() string
type GetQuotaRequest ¶
type GetQuotaRequest struct {
// The OCID of the quota.
QuotaId *string `mandatory:"true" contributesTo:"path" name:"quotaId"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`
// Metadata about the request. This information will not be transmitted to the service, but
// represents information that the SDK will consume to drive retry behavior.
RequestMetadata common.RequestMetadata
}
GetQuotaRequest wrapper for the GetQuota operation
func (GetQuotaRequest) HTTPRequest ¶
func (request GetQuotaRequest) HTTPRequest(method, path string) (http.Request, error)
HTTPRequest implements the OCIRequest interface
func (GetQuotaRequest) RetryPolicy ¶
func (request GetQuotaRequest) RetryPolicy() *common.RetryPolicy
RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.
func (GetQuotaRequest) String ¶
func (request GetQuotaRequest) String() string
type GetQuotaResponse ¶
type GetQuotaResponse struct {
// The underlying http response
RawResponse *http.Response
// The Quota instance
Quota `presentIn:"body"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
// For optimistic concurrency control. See `if-match`.
Etag *string `presentIn:"header" name:"etag"`
}
GetQuotaResponse wrapper for the GetQuota operation
func (GetQuotaResponse) HTTPResponse ¶
func (response GetQuotaResponse) HTTPResponse() *http.Response
HTTPResponse implements the OCIResponse interface
func (GetQuotaResponse) String ¶
func (response GetQuotaResponse) String() string
type ListQuotasLifecycleStateEnum ¶
type ListQuotasLifecycleStateEnum string
ListQuotasLifecycleStateEnum Enum with underlying type: string
const (
ListQuotasLifecycleStateActive ListQuotasLifecycleStateEnum = "ACTIVE"
)
Set of constants representing the allowable values for ListQuotasLifecycleStateEnum
func GetListQuotasLifecycleStateEnumValues ¶
func GetListQuotasLifecycleStateEnumValues() []ListQuotasLifecycleStateEnum
GetListQuotasLifecycleStateEnumValues Enumerates the set of values for ListQuotasLifecycleStateEnum
type ListQuotasRequest ¶
type ListQuotasRequest struct {
// The OCID of the parent compartment (remember that the tenancy is simply the root compartment).
CompartmentId *string `mandatory:"true" contributesTo:"query" name:"compartmentId"`
// The value of the `opc-next-page` response header from the previous "List" call.
Page *string `mandatory:"false" contributesTo:"query" name:"page"`
// The maximum number of items to return in a paginated "List" call.
Limit *int `mandatory:"false" contributesTo:"query" name:"limit"`
// name
Name *string `mandatory:"false" contributesTo:"query" name:"name"`
// Filters returned quotas based on whether the given state.
LifecycleState ListQuotasLifecycleStateEnum `mandatory:"false" contributesTo:"query" name:"lifecycleState" omitEmpty:"true"`
// The sort order to use, either 'asc' or 'desc'.
SortOrder ListQuotasSortOrderEnum `mandatory:"false" contributesTo:"query" name:"sortOrder" omitEmpty:"true"`
// The field to sort by. Only one sort order may be provided. Time created is default ordered as descending. Display name is default ordered as ascending.
SortBy ListQuotasSortByEnum `mandatory:"false" contributesTo:"query" name:"sortBy" omitEmpty:"true"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`
// Metadata about the request. This information will not be transmitted to the service, but
// represents information that the SDK will consume to drive retry behavior.
RequestMetadata common.RequestMetadata
}
ListQuotasRequest wrapper for the ListQuotas operation
func (ListQuotasRequest) HTTPRequest ¶
func (request ListQuotasRequest) HTTPRequest(method, path string) (http.Request, error)
HTTPRequest implements the OCIRequest interface
func (ListQuotasRequest) RetryPolicy ¶
func (request ListQuotasRequest) RetryPolicy() *common.RetryPolicy
RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.
func (ListQuotasRequest) String ¶
func (request ListQuotasRequest) String() string
type ListQuotasResponse ¶
type ListQuotasResponse struct {
// The underlying http response
RawResponse *http.Response
// A list of []QuotaSummary instances
Items []QuotaSummary `presentIn:"body"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
// For pagination of a list of items. When paging through a list, if this header appears in the response,
// then a partial list might have been returned. Include this value as the `page` parameter for the
// subsequent GET request to get the next batch of items.
OpcNextPage *string `presentIn:"header" name:"opc-next-page"`
}
ListQuotasResponse wrapper for the ListQuotas operation
func (ListQuotasResponse) HTTPResponse ¶
func (response ListQuotasResponse) HTTPResponse() *http.Response
HTTPResponse implements the OCIResponse interface
func (ListQuotasResponse) String ¶
func (response ListQuotasResponse) String() string
type ListQuotasSortByEnum ¶
type ListQuotasSortByEnum string
ListQuotasSortByEnum Enum with underlying type: string
const ( ListQuotasSortByName ListQuotasSortByEnum = "NAME" ListQuotasSortByTimecreated ListQuotasSortByEnum = "TIMECREATED" )
Set of constants representing the allowable values for ListQuotasSortByEnum
func GetListQuotasSortByEnumValues ¶
func GetListQuotasSortByEnumValues() []ListQuotasSortByEnum
GetListQuotasSortByEnumValues Enumerates the set of values for ListQuotasSortByEnum
type ListQuotasSortOrderEnum ¶
type ListQuotasSortOrderEnum string
ListQuotasSortOrderEnum Enum with underlying type: string
const ( ListQuotasSortOrderAsc ListQuotasSortOrderEnum = "ASC" ListQuotasSortOrderDesc ListQuotasSortOrderEnum = "DESC" )
Set of constants representing the allowable values for ListQuotasSortOrderEnum
func GetListQuotasSortOrderEnumValues ¶
func GetListQuotasSortOrderEnumValues() []ListQuotasSortOrderEnum
GetListQuotasSortOrderEnumValues Enumerates the set of values for ListQuotasSortOrderEnum
type Quota ¶
type Quota struct {
// The OCID of the quota.
Id *string `mandatory:"true" json:"id"`
// The OCID of the compartment containing the resource this quota applies to.
CompartmentId *string `mandatory:"true" json:"compartmentId"`
// The name you assign to the quota during creation. The name must be unique across all quotas
// in the tenancy and cannot be changed.
Name *string `mandatory:"true" json:"name"`
// An array of one or more quota statements written in the declarative language.
Statements []string `mandatory:"true" json:"statements"`
// The description you assign to the quota.
Description *string `mandatory:"true" json:"description"`
// Date and time the quota was created, in the format defined by RFC3339.
// Example: `2016-08-25T21:10:29.600Z`
TimeCreated *common.SDKTime `mandatory:"true" json:"timeCreated"`
// The quota's current state. After creating a quota, make sure its `lifecycleState` is set to
// ACTIVE before using it.
LifecycleState QuotaLifecycleStateEnum `mandatory:"false" json:"lifecycleState,omitempty"`
// 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 (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Department": "Finance"}`
FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
// Defined tags for this resource. Each key is predefined and scoped to a namespace.
// For more information, see Resource Tags (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Operations": {"CostCenter": "42"}}`
DefinedTags map[string]map[string]interface{} `mandatory:"false" json:"definedTags"`
}
Quota Quotas are applied on top of the service limits and inherited through the nested compartment hierarchy. They allow compartment admins to limit resource consumption and set boundaries around acceptable resource use. The word "quota" is used by people in different ways:
- An individual statement written in the declarative language
- A collection of statements in a single, named "quota" object (which has an Oracle Cloud ID (OCID) assigned to it)
- The overall body of quotas your organization uses to control access to resources
type QuotaLifecycleStateEnum ¶
type QuotaLifecycleStateEnum string
QuotaLifecycleStateEnum Enum with underlying type: string
const (
QuotaLifecycleStateActive QuotaLifecycleStateEnum = "ACTIVE"
)
Set of constants representing the allowable values for QuotaLifecycleStateEnum
func GetQuotaLifecycleStateEnumValues ¶
func GetQuotaLifecycleStateEnumValues() []QuotaLifecycleStateEnum
GetQuotaLifecycleStateEnumValues Enumerates the set of values for QuotaLifecycleStateEnum
type QuotaSummary ¶
type QuotaSummary struct {
// The OCID of the quota.
Id *string `mandatory:"true" json:"id"`
// The OCID of the compartment containing the resource this quota applies to.
CompartmentId *string `mandatory:"true" json:"compartmentId"`
// The name you assign to the quota during creation. The name must be unique across all quotas
// in the tenancy and cannot be changed.
Name *string `mandatory:"true" json:"name"`
// The description you assign to the quota.
Description *string `mandatory:"true" json:"description"`
// Date and time the quota was created, in the format defined by RFC3339.
// Example: `2016-08-25T21:10:29.600Z`
TimeCreated *common.SDKTime `mandatory:"true" json:"timeCreated"`
// The quota's current state. After creating a quota, make sure its `lifecycleState` is set to
// ACTIVE before using it.
LifecycleState QuotaSummaryLifecycleStateEnum `mandatory:"false" json:"lifecycleState,omitempty"`
// 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 (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Department": "Finance"}`
FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
// Defined tags for this resource. Each key is predefined and scoped to a namespace.
// For more information, see Resource Tags (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Operations": {"CostCenter": "42"}}`
DefinedTags map[string]map[string]interface{} `mandatory:"false" json:"definedTags"`
}
QuotaSummary Entails a subset of all the properties of the corresponding Quota and is recommended to be used in cases requiring security of quota details and slightly better API performance.
func (QuotaSummary) String ¶
func (m QuotaSummary) String() string
type QuotaSummaryLifecycleStateEnum ¶
type QuotaSummaryLifecycleStateEnum string
QuotaSummaryLifecycleStateEnum Enum with underlying type: string
const (
QuotaSummaryLifecycleStateActive QuotaSummaryLifecycleStateEnum = "ACTIVE"
)
Set of constants representing the allowable values for QuotaSummaryLifecycleStateEnum
func GetQuotaSummaryLifecycleStateEnumValues ¶
func GetQuotaSummaryLifecycleStateEnumValues() []QuotaSummaryLifecycleStateEnum
GetQuotaSummaryLifecycleStateEnumValues Enumerates the set of values for QuotaSummaryLifecycleStateEnum
type QuotasClient ¶
type QuotasClient struct {
common.BaseClient
// contains filtered or unexported fields
}
QuotasClient a client for Quotas
func NewQuotasClientWithConfigurationProvider ¶
func NewQuotasClientWithConfigurationProvider(configProvider common.ConfigurationProvider) (client QuotasClient, err error)
NewQuotasClientWithConfigurationProvider Creates a new default Quotas client with the given configuration provider. the configuration provider will be used for the default signer as well as reading the region
func (*QuotasClient) ConfigurationProvider ¶
func (client *QuotasClient) ConfigurationProvider() *common.ConfigurationProvider
ConfigurationProvider the ConfigurationProvider used in this client, or null if none set
func (QuotasClient) CreateQuota ¶
func (client QuotasClient) CreateQuota(ctx context.Context, request CreateQuotaRequest) (response CreateQuotaResponse, err error)
CreateQuota Creates a new quota with the details supplied.
func (QuotasClient) DeleteQuota ¶
func (client QuotasClient) DeleteQuota(ctx context.Context, request DeleteQuotaRequest) (response DeleteQuotaResponse, err error)
DeleteQuota Deletes the quota corresponding to the given OCID.
func (QuotasClient) GetQuota ¶
func (client QuotasClient) GetQuota(ctx context.Context, request GetQuotaRequest) (response GetQuotaResponse, err error)
GetQuota Gets the quota for the OCID specified.
func (QuotasClient) ListQuotas ¶
func (client QuotasClient) ListQuotas(ctx context.Context, request ListQuotasRequest) (response ListQuotasResponse, err error)
ListQuotas Lists all quotas on resources from the given compartment
func (*QuotasClient) SetRegion ¶
func (client *QuotasClient) SetRegion(region string)
SetRegion overrides the region of this client.
func (QuotasClient) UpdateQuota ¶
func (client QuotasClient) UpdateQuota(ctx context.Context, request UpdateQuotaRequest) (response UpdateQuotaResponse, err error)
UpdateQuota Updates the quota corresponding to given OCID with the details supplied.
type UpdateQuotaDetails ¶
type UpdateQuotaDetails struct {
// The description you assign to the quota.
Description *string `mandatory:"false" json:"description"`
// An array of quota statements written in the declarative language.
Statements []string `mandatory:"false" json:"statements"`
// 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 (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Department": "Finance"}`
FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`
// Defined tags for this resource. Each key is predefined and scoped to a namespace.
// For more information, see Resource Tags (https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm).
// Example: `{"Operations": {"CostCenter": "42"}}`
DefinedTags map[string]map[string]interface{} `mandatory:"false" json:"definedTags"`
}
UpdateQuotaDetails Request object for update quota operation.
func (UpdateQuotaDetails) String ¶
func (m UpdateQuotaDetails) String() string
type UpdateQuotaRequest ¶
type UpdateQuotaRequest struct {
// The OCID of the quota.
QuotaId *string `mandatory:"true" contributesTo:"path" name:"quotaId"`
// Request object for updating a quota.
UpdateQuotaDetails `contributesTo:"body"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`
// For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
// parameter to the value of the etag from a previous GET or POST response for that resource. The resource
// will be updated or deleted only if the etag you provide matches the resource's current etag value.
IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`
// Metadata about the request. This information will not be transmitted to the service, but
// represents information that the SDK will consume to drive retry behavior.
RequestMetadata common.RequestMetadata
}
UpdateQuotaRequest wrapper for the UpdateQuota operation
func (UpdateQuotaRequest) HTTPRequest ¶
func (request UpdateQuotaRequest) HTTPRequest(method, path string) (http.Request, error)
HTTPRequest implements the OCIRequest interface
func (UpdateQuotaRequest) RetryPolicy ¶
func (request UpdateQuotaRequest) RetryPolicy() *common.RetryPolicy
RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.
func (UpdateQuotaRequest) String ¶
func (request UpdateQuotaRequest) String() string
type UpdateQuotaResponse ¶
type UpdateQuotaResponse struct {
// The underlying http response
RawResponse *http.Response
// The Quota instance
Quota `presentIn:"body"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
// particular request, please provide the request ID.
OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
// For optimistic concurrency control. See `if-match`.
Etag *string `presentIn:"header" name:"etag"`
}
UpdateQuotaResponse wrapper for the UpdateQuota operation
func (UpdateQuotaResponse) HTTPResponse ¶
func (response UpdateQuotaResponse) HTTPResponse() *http.Response
HTTPResponse implements the OCIResponse interface
func (UpdateQuotaResponse) String ¶
func (response UpdateQuotaResponse) String() string