Releasing version 65.78.0

Releasing version 65.78.0

CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 
+## 65.78.0 - 2024-11-05
+### Added 
+- Support for calling Oracle Cloud Infrastructure services in the `ap-seoul-2` region 
+- Support for calling Oracle Cloud Infrastructure services in the `ap-suwon-1` region 
+- Support for calling Oracle Cloud Infrastructure services in the `ap-chuncheon-2` region 
+- Support for MFA Enablement v2 in the Identity Domains service 
+- Support for starting, stopping and updating min/max executor count for SQL Endpoints in the Data Flow service 
+- Support for customer message in the Customer Incident Management Service 
+- Support for REJECTED limitStatus in the Customer Incident Management Service   
+
+### Breaking Changes 
+- The retry strategy for getting the X509 token from Identity service was modified and is now protected via circuit breaker 
+- The operations `GetCsiNumber` and `GetStatus` were removed from the `IncidentClient` in the Customer Incident Management Service 
+- The property `ServiceCategories` was removed from the model `IncidentResourceType` in the Customer Incident Management Service 
+- The properties `ServiceCategory` and `IssueType` were removed from the model `ServiceCategories` in the Customer Incident Management Service 
+- The property `ItemKey` was made mandatory in the model `AccountItem` in the Customer Incident Management Service
+
 ## 65.77.1 - 2024-10-29
 ### Added 
 - Support for L3IP (Layer 3 IP) listeners in the Network Load Balancing service 

cims/account_item.go

@@ -24,7 +24,7 @@ import (
 type AccountItem struct {
 
 	// Unique identifier for the item.
-	ItemKey *string `mandatory:"true" json:"itemKey"`
+	ItemKey *string `mandatory:"false" json:"itemKey"`
 
 	// The display name of the item. Avoid entering confidential information.
 	Name *string `mandatory:"false" json:"name"`

cims/activity_item.go

@@ -23,18 +23,18 @@ import (
 // ActivityItem Details about the ActivityItem object.
 type ActivityItem struct {
 
-	// Unique identifier for the item.
-	ItemKey *string `mandatory:"true" json:"itemKey"`
-
 	// Comments added with the activity on the support ticket.
 	Comments *string `mandatory:"true" json:"comments"`
 
-	// The time when the activity was created, in milliseconds since epoch time.
+	// The time when the activity was created, in seconds since epoch time.
 	TimeCreated *int `mandatory:"true" json:"timeCreated"`
 
-	// The time when the activity was updated, in milliseconds since epoch time.
+	// The time when the activity was updated, in seconds since epoch time.
 	TimeUpdated *int `mandatory:"true" json:"timeUpdated"`
 
+	// Unique identifier for the item.
+	ItemKey *string `mandatory:"false" json:"itemKey"`
+
 	// The display name of the item. Avoid entering confidential information.
 	Name *string `mandatory:"false" json:"name"`
 
@@ -44,6 +44,9 @@ type ActivityItem struct {
 
 	IssueType *IssueType `mandatory:"false" json:"issueType"`
 
+	// attachmentID for the ItemType Attachments only for Alloy realm.
+	AttachmentID *string `mandatory:"false" json:"attachmentID"`
+
 	// The type of activity occuring on the support ticket.
 	ActivityType ActivityItemActivityTypeEnum `mandatory:"true" json:"activityType"`
 

cims/cims_incident_client.go

@@ -95,7 +95,8 @@ func (client *IncidentClient) ConfigurationProvider() *common.ConfigurationProvi
 	return client.config
 }
 
-// CreateIncident Operation to create a support ticket.
+// CreateIncident Creates a support ticket in the specified tenancy.
+// For more information, see Creating Support Requests (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident.htm).
 //
 // # See also
 //
@@ -152,64 +153,8 @@ func (client IncidentClient) createIncident(ctx context.Context, request common.
 	return response, err
 }
 
-// GetCsiNumber Fetches csi number of the user.
-//
-// # See also
-//
-// Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/latest/cims/GetCsiNumber.go.html to see an example of how to use GetCsiNumber API.
-func (client IncidentClient) GetCsiNumber(ctx context.Context, request GetCsiNumberRequest) (response GetCsiNumberResponse, err error) {
-	var ociResponse common.OCIResponse
-	policy := common.NoRetryPolicy()
-	if client.RetryPolicy() != nil {
-		policy = *client.RetryPolicy()
-	}
-	if request.RetryPolicy() != nil {
-		policy = *request.RetryPolicy()
-	}
-	ociResponse, err = common.Retry(ctx, request, client.getCsiNumber, policy)
-	if err != nil {
-		if ociResponse != nil {
-			if httpResponse := ociResponse.HTTPResponse(); httpResponse != nil {
-				opcRequestId := httpResponse.Header.Get("opc-request-id")
-				response = GetCsiNumberResponse{RawResponse: httpResponse, OpcRequestId: &opcRequestId}
-			} else {
-				response = GetCsiNumberResponse{}
-			}
-		}
-		return
-	}
-	if convertedResponse, ok := ociResponse.(GetCsiNumberResponse); ok {
-		response = convertedResponse
-	} else {
-		err = fmt.Errorf("failed to convert OCIResponse into GetCsiNumberResponse")
-	}
-	return
-}
-
-// getCsiNumber implements the OCIOperation interface (enables retrying operations)
-func (client IncidentClient) getCsiNumber(ctx context.Context, request common.OCIRequest, binaryReqBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (common.OCIResponse, error) {
-
-	httpRequest, err := request.HTTPRequest(http.MethodGet, "/v2/incidents/getCsiNumber", binaryReqBody, extraHeaders)
-	if err != nil {
-		return nil, err
-	}
-
-	var response GetCsiNumberResponse
-	var httpResponse *http.Response
-	httpResponse, err = client.Call(ctx, &httpRequest)
-	defer common.CloseBodyIfValid(httpResponse)
-	response.RawResponse = httpResponse
-	if err != nil {
-		apiReferenceLink := ""
-		err = common.PostProcessServiceError(err, "Incident", "GetCsiNumber", apiReferenceLink)
-		return response, err
-	}
-
-	err = common.UnmarshalResponse(httpResponse, &response)
-	return response, err
-}
-
-// GetIncident Gets details about the specified support ticket.
+// GetIncident Gets the specified support ticket.
+// For more information, see Getting Details for a Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/get-incident.htm).
 //
 // # See also
 //
@@ -266,64 +211,14 @@ func (client IncidentClient) getIncident(ctx context.Context, request common.OCI
 	return response, err
 }
 
-// GetStatus Gets the status of the service.
-//
-// # See also
-//
-// Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/latest/cims/GetStatus.go.html to see an example of how to use GetStatus API.
-func (client IncidentClient) GetStatus(ctx context.Context, request GetStatusRequest) (response GetStatusResponse, err error) {
-	var ociResponse common.OCIResponse
-	policy := common.NoRetryPolicy()
-	if client.RetryPolicy() != nil {
-		policy = *client.RetryPolicy()
-	}
-	if request.RetryPolicy() != nil {
-		policy = *request.RetryPolicy()
-	}
-	ociResponse, err = common.Retry(ctx, request, client.getStatus, policy)
-	if err != nil {
-		if ociResponse != nil {
-			if httpResponse := ociResponse.HTTPResponse(); httpResponse != nil {
-				opcRequestId := httpResponse.Header.Get("opc-request-id")
-				response = GetStatusResponse{RawResponse: httpResponse, OpcRequestId: &opcRequestId}
-			} else {
-				response = GetStatusResponse{}
-			}
-		}
-		return
-	}
-	if convertedResponse, ok := ociResponse.(GetStatusResponse); ok {
-		response = convertedResponse
-	} else {
-		err = fmt.Errorf("failed to convert OCIResponse into GetStatusResponse")
-	}
-	return
-}
-
-// getStatus implements the OCIOperation interface (enables retrying operations)
-func (client IncidentClient) getStatus(ctx context.Context, request common.OCIRequest, binaryReqBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (common.OCIResponse, error) {
-
-	httpRequest, err := request.HTTPRequest(http.MethodGet, "/v2/incidents/status", binaryReqBody, extraHeaders)
-	if err != nil {
-		return nil, err
-	}
-
-	var response GetStatusResponse
-	var httpResponse *http.Response
-	httpResponse, err = client.Call(ctx, &httpRequest)
-	defer common.CloseBodyIfValid(httpResponse)
-	response.RawResponse = httpResponse
-	if err != nil {
-		apiReferenceLink := "https://docs.oracle.com/iaas/api/#/en/incidentmanagement/20181231/Status/GetStatus"
-		err = common.PostProcessServiceError(err, "Incident", "GetStatus", apiReferenceLink)
-		return response, err
-	}
-
-	err = common.UnmarshalResponse(httpResponse, &response)
-	return response, err
-}
-
-// ListIncidentResourceTypes During support ticket creation, returns the list of all possible products that Oracle Cloud Infrastructure supports.
+// ListIncidentResourceTypes Depending on the selected `productType`, either
+// lists available products (service groups, services, service categories, and subcategories) for technical support tickets or
+// lists limits and current usage for limit increase tickets.
+// This operation is called during creation of technical support and limit increase tickets.
+// For more information about listing products, see
+// Listing Products for Support Requests (https://docs.cloud.oracle.com/iaas/Content/GSG/support/list-incident-resource-types-taxonomy.htm).
+// For more information about listing limits, see
+// Listing Limits for Service Limit Increase Requests (https://docs.cloud.oracle.com/iaas/Content/GSG/support/list-incident-resource-types-limit.htm).
 //
 // # See also
 //
@@ -380,7 +275,8 @@ func (client IncidentClient) listIncidentResourceTypes(ctx context.Context, requ
 	return response, err
 }
 
-// ListIncidents Returns the list of support tickets raised by the tenancy.
+// ListIncidents Lists support tickets for the specified tenancy.
+// For more information, see Listing Support Requests (https://docs.cloud.oracle.com/iaas/Content/GSG/support/list-incidents.htm).
 //
 // # See also
 //
@@ -437,7 +333,8 @@ func (client IncidentClient) listIncidents(ctx context.Context, request common.O
 	return response, err
 }
 
-// UpdateIncident Updates the specified support ticket's information.
+// UpdateIncident Updates the specified support ticket.
+// For more information, see Updating Support Requests (https://docs.cloud.oracle.com/iaas/Content/GSG/support/update-incident.htm).
 //
 // # See also
 //
@@ -495,6 +392,7 @@ func (client IncidentClient) updateIncident(ctx context.Context, request common.
 }
 
 // ValidateUser Checks whether the requested user is valid.
+// For more information, see Validating a User (https://docs.cloud.oracle.com/iaas/Content/GSG/support/validate-user.htm).
 //
 // # See also
 //

cims/create_account_item_details.go

@@ -21,6 +21,7 @@ import (
 )
 
 // CreateAccountItemDetails Details about the issue that the account support ticket relates to. Avoid entering confidential information.
+// For information about `ACCOUNT` support tickets, see Creating a Billing Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-billing.htm).
 type CreateAccountItemDetails struct {
 	Category *CreateCategoryDetails `mandatory:"false" json:"category"`
 

cims/create_incident.go

@@ -27,7 +27,13 @@ type CreateIncident struct {
 
 	Ticket *CreateTicketDetails `mandatory:"true" json:"ticket"`
 
-	// The kind of support ticket, such as a technical support request or a limit increase request.
+	// The kind of support ticket (type of support request).
+	// For information about `ACCOUNT` support tickets, see
+	// Creating a Billing Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-billing.htm).
+	// For information about `LIMIT` support tickets, see
+	// Creating a Service Limit Increase Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-limit.htm).
+	// For information about `TECH` support tickets, see
+	// Creating a Technical Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-technical.htm).
 	ProblemType ProblemTypeEnum `mandatory:"true" json:"problemType"`
 
 	// The Customer Support Identifier (CSI) number associated with the support account.

cims/create_incident_request_response.go

@@ -25,6 +25,7 @@ type CreateIncidentRequest struct {
 	OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`
 
 	// User OCID for Oracle Identity Cloud Service (IDCS) users who also have a federated Oracle Cloud Infrastructure account.
+	// User OCID is mandatory for OCI Users and optional for Multicloud users.
 	Ocid *string `mandatory:"false" contributesTo:"header" name:"ocid"`
 
 	// The region of the tenancy.
@@ -40,6 +41,7 @@ type CreateIncidentRequest struct {
 	Idtoken *string `mandatory:"false" contributesTo:"header" name:"idtoken"`
 
 	// The OCID of identity domain.
+	// DomainID is mandatory if the user is part of Non Default Identity domain.
 	Domainid *string `mandatory:"false" contributesTo:"header" name:"domainid"`
 
 	// Metadata about the request. This information will not be transmitted to the service, but

cims/create_limit_item_details.go

@@ -21,6 +21,7 @@ import (
 )
 
 // CreateLimitItemDetails Details about the service limit increase request. Avoid entering confidential information.
+// For information about `LIMIT` support tickets, see Creating a Service Limit Increase Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-limit.htm).
 type CreateLimitItemDetails struct {
 	Category *CreateCategoryDetails `mandatory:"false" json:"category"`
 
@@ -105,18 +106,21 @@ const (
 	CreateLimitItemDetailsLimitStatusApproved          CreateLimitItemDetailsLimitStatusEnum = "APPROVED"
 	CreateLimitItemDetailsLimitStatusPartiallyApproved CreateLimitItemDetailsLimitStatusEnum = "PARTIALLY_APPROVED"
 	CreateLimitItemDetailsLimitStatusNotApproved       CreateLimitItemDetailsLimitStatusEnum = "NOT_APPROVED"
+	CreateLimitItemDetailsLimitStatusRejected          CreateLimitItemDetailsLimitStatusEnum = "REJECTED"
 )
 
 var mappingCreateLimitItemDetailsLimitStatusEnum = map[string]CreateLimitItemDetailsLimitStatusEnum{
 	"APPROVED":           CreateLimitItemDetailsLimitStatusApproved,
 	"PARTIALLY_APPROVED": CreateLimitItemDetailsLimitStatusPartiallyApproved,
 	"NOT_APPROVED":       CreateLimitItemDetailsLimitStatusNotApproved,
+	"REJECTED":           CreateLimitItemDetailsLimitStatusRejected,
 }
 
 var mappingCreateLimitItemDetailsLimitStatusEnumLowerCase = map[string]CreateLimitItemDetailsLimitStatusEnum{
 	"approved":           CreateLimitItemDetailsLimitStatusApproved,
 	"partially_approved": CreateLimitItemDetailsLimitStatusPartiallyApproved,
 	"not_approved":       CreateLimitItemDetailsLimitStatusNotApproved,
+	"rejected":           CreateLimitItemDetailsLimitStatusRejected,
 }
 
 // GetCreateLimitItemDetailsLimitStatusEnumValues Enumerates the set of values for CreateLimitItemDetailsLimitStatusEnum
@@ -134,6 +138,7 @@ func GetCreateLimitItemDetailsLimitStatusEnumStringValues() []string {
 		"APPROVED",
 		"PARTIALLY_APPROVED",
 		"NOT_APPROVED",
+		"REJECTED",
 	}
 }
 

cims/create_tech_support_item_details.go

@@ -21,6 +21,7 @@ import (
 )
 
 // CreateTechSupportItemDetails Details about the issue that the technical support ticket relates to. Avoid entering confidential information.
+// For information about `TECH` support tickets, see Creating a Technical Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-technical.htm).
 type CreateTechSupportItemDetails struct {
 	Category *CreateCategoryDetails `mandatory:"false" json:"category"`
 

cims/create_user_details.go

@@ -43,7 +43,13 @@ type CreateUserDetails struct {
 	// Organization of the user.
 	OrganizationName *string `mandatory:"true" json:"organizationName"`
 
-	// The kind of support ticket, such as a technical support request or a limit increase request.
+	// The kind of support ticket (type of support request).
+	// For information about `ACCOUNT` support tickets, see
+	// Creating a Billing Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-billing.htm).
+	// For information about `LIMIT` support tickets, see
+	// Creating a Service Limit Increase Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-limit.htm).
+	// For information about `TECH` support tickets, see
+	// Creating a Technical Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-technical.htm).
 	ProblemType ProblemTypeEnum `mandatory:"true" json:"problemType"`
 }
 

cims/get_incident_request_response.go

@@ -21,21 +21,23 @@ type GetIncidentRequest struct {
 	// Unique identifier for the support ticket.
 	IncidentKey *string `mandatory:"true" contributesTo:"path" name:"incidentKey"`
 
+	// The OCID of the tenancy.
+	CompartmentId *string `mandatory:"true" contributesTo:"query" name:"compartmentId"`
+
 	// 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"`
 
-	// The Customer Support Identifier (CSI) associated with the support account.
+	// The Customer Support Identifier (CSI) number associated with the support account.
+	// The CSI is required for technical support tickets and optional for limits and billing tickets.
 	Csi *string `mandatory:"false" contributesTo:"header" name:"csi"`
 
 	// User OCID for Oracle Identity Cloud Service (IDCS) users who also have a federated Oracle Cloud Infrastructure account.
+	// User OCID is mandatory for OCI Users and optional for Multicloud users.
 	Ocid *string `mandatory:"false" contributesTo:"header" name:"ocid"`
 
 	// The region of the tenancy.
 	Homeregion *string `mandatory:"false" contributesTo:"header" name:"homeregion"`
 
-	// The OCID of the tenancy.
-	CompartmentId *string `mandatory:"false" contributesTo:"query" name:"compartmentId"`
-
 	// The kind of support request.
 	Problemtype *string `mandatory:"false" contributesTo:"header" name:"problemtype"`
 
@@ -49,6 +51,7 @@ type GetIncidentRequest struct {
 	Idtoken *string `mandatory:"false" contributesTo:"header" name:"idtoken"`
 
 	// The OCID of identity domain.
+	// DomainID is mandatory if the user is part of Non Default Identity domain.
 	Domainid *string `mandatory:"false" contributesTo:"header" name:"domainid"`
 
 	// Metadata about the request. This information will not be transmitted to the service, but

cims/incident.go

@@ -36,7 +36,13 @@ type Incident struct {
 
 	IncidentType *IncidentType `mandatory:"false" json:"incidentType"`
 
-	// The kind of support ticket, such as a technical support request or a limit increase request.
+	// The kind of support ticket (type of support request).
+	// For information about `ACCOUNT` support tickets, see
+	// Creating a Billing Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-billing.htm).
+	// For information about `LIMIT` support tickets, see
+	// Creating a Service Limit Increase Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-limit.htm).
+	// For information about `TECH` support tickets, see
+	// Creating a Technical Support Request (https://docs.cloud.oracle.com/iaas/Content/GSG/support/create-incident-technical.htm).
 	ProblemType ProblemTypeEnum `mandatory:"false" json:"problemType,omitempty"`
 
 	// The incident referrer. This value is often the URL that the customer used when creating the support ticket.