Update security finding triage specs (DataDog#3522)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -20,7 +20,8 @@ import (
 type SecurityMonitoringApi datadog.Service
 
 // AttachCase Attach security findings to a case.
-// Attach security findings to a case. You can attach up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the specified case.
+// Attach security findings to a case.
+// You can attach up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the specified case.
 func (a *SecurityMonitoringApi) AttachCase(ctx _context.Context, caseId string, body AttachCaseRequest) (FindingCaseResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPatch
@@ -101,7 +102,8 @@ func (a *SecurityMonitoringApi) AttachCase(ctx _context.Context, caseId string,
 }
 
 // AttachJiraIssue Attach security findings to a Jira issue.
-// Attach security findings to a Jira issue by providing the Jira issue URL. You can attach up to 50 security findings per Jira issue. If the Jira issue is not linked to any case, this operation will create a case for the security findings and link the Jira issue to the newly created case. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the specified Jira issue.
+// Attach security findings to a Jira issue by providing the Jira issue URL.
+// You can attach up to 50 security findings per Jira issue. If the Jira issue is not linked to any case, this operation will create a case for the security findings and link the Jira issue to the newly created case. To configure the Jira integration, see [Bidirectional ticket syncing with Jira](https://docs.datadoghq.com/security/ticketing_integrations/#bidirectional-ticket-syncing-with-jira). Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the specified Jira issue.
 func (a *SecurityMonitoringApi) AttachJiraIssue(ctx _context.Context, body AttachJiraIssueRequest) (FindingCaseResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPatch
@@ -516,7 +518,8 @@ func (a *SecurityMonitoringApi) ConvertSecurityMonitoringRuleFromJSONToTerraform
 }
 
 // CreateCases Create cases for security findings.
-// Create cases for security findings. You can create up to 50 cases per request and associate up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the newly created case.
+// Create cases for security findings.
+// You can create up to 50 cases per request and associate up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the newly created case.
 func (a *SecurityMonitoringApi) CreateCases(ctx _context.Context, body CreateCaseRequestArray) (FindingCaseResponseArray, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost
@@ -676,7 +679,8 @@ func (a *SecurityMonitoringApi) CreateCustomFramework(ctx _context.Context, body
 }
 
 // CreateJiraIssues Create Jira issues for security findings.
-// Create Jira issues for security findings. This operation creates a case in Datadog and a Jira issue linked to that case for bidirectional sync between Datadog and Jira. You can create up to 50 Jira issues per request and associate up to 50 security findings per Jira issue. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the newly created Jira issue.
+// Create Jira issues for security findings.
+// This operation creates a case in Datadog and a Jira issue linked to that case for bidirectional sync between Datadog and Jira. To configure the Jira integration, see [Bidirectional ticket syncing with Jira](https://docs.datadoghq.com/security/ticketing_integrations/#bidirectional-ticket-syncing-with-jira). You can create up to 50 Jira issues per request and associate up to 50 security findings per Jira issue. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the newly created Jira issue.
 func (a *SecurityMonitoringApi) CreateJiraIssues(ctx _context.Context, body CreateJiraIssueRequestArray) (FindingCaseResponseArray, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost
@@ -1664,7 +1668,8 @@ func (a *SecurityMonitoringApi) DeleteVulnerabilityNotificationRule(ctx _context
 }
 
 // DetachCase Detach security findings from their case.
-// Detach security findings from their case. This operation dissociates security findings from their associated cases without deleting the cases themselves. You can detach security findings from multiple different cases in a single request, with a limit of 50 security findings per request. Security findings that are not currently attached to any case will be ignored.
+// Detach security findings from their case.
+// This operation dissociates security findings from their associated cases without deleting the cases themselves. You can detach security findings from multiple different cases in a single request, with a limit of 50 security findings per request. Security findings that are not currently attached to any case will be ignored.
 func (a *SecurityMonitoringApi) DetachCase(ctx _context.Context, body DetachCaseRequest) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod = _nethttp.MethodDelete

api/datadogV2/api_security_monitoring.go

@@ -12,7 +12,7 @@ import (
 
 // AttachCaseRequestData Data of the case to attach security findings to.
 type AttachCaseRequestData struct {
-	// The unique identifier of the case.
+	// Unique identifier of the case.
 	Id string `json:"id"`
 	// Relationships of the case to attach security findings to.
 	Relationships *AttachCaseRequestDataRelationships `json:"relationships,omitempty"`

api/datadogV2/model_attach_case_request_data.go

@@ -14,8 +14,6 @@ import (
 type AttachJiraIssueRequestData struct {
 	// Attributes of the Jira issue to attach security findings to.
 	Attributes *AttachJiraIssueRequestDataAttributes `json:"attributes,omitempty"`
-	// The unique identifier of the Jira issue attachment request.
-	Id *string `json:"id,omitempty"`
 	// Relationships of the Jira issue to attach security findings to.
 	Relationships *AttachJiraIssueRequestDataRelationships `json:"relationships,omitempty"`
 	// Jira issues resource type.
@@ -73,34 +71,6 @@ func (o *AttachJiraIssueRequestData) SetAttributes(v AttachJiraIssueRequestDataA
 	o.Attributes = &v
 }
 
-// GetId returns the Id field value if set, zero value otherwise.
-func (o *AttachJiraIssueRequestData) GetId() string {
-	if o == nil || o.Id == nil {
-		var ret string
-		return ret
-	}
-	return *o.Id
-}
-
-// GetIdOk returns a tuple with the Id field value if set, nil otherwise
-// and a boolean to check if the value has been set.
-func (o *AttachJiraIssueRequestData) GetIdOk() (*string, bool) {
-	if o == nil || o.Id == nil {
-		return nil, false
-	}
-	return o.Id, true
-}
-
-// HasId returns a boolean if a field has been set.
-func (o *AttachJiraIssueRequestData) HasId() bool {
-	return o != nil && o.Id != nil
-}
-
-// SetId gets a reference to the given string and assigns it to the Id field.
-func (o *AttachJiraIssueRequestData) SetId(v string) {
-	o.Id = &v
-}
-
 // GetRelationships returns the Relationships field value if set, zero value otherwise.
 func (o *AttachJiraIssueRequestData) GetRelationships() AttachJiraIssueRequestDataRelationships {
 	if o == nil || o.Relationships == nil {
@@ -161,9 +131,6 @@ func (o AttachJiraIssueRequestData) MarshalJSON() ([]byte, error) {
 	if o.Attributes != nil {
 		toSerialize["attributes"] = o.Attributes
 	}
-	if o.Id != nil {
-		toSerialize["id"] = o.Id
-	}
 	if o.Relationships != nil {
 		toSerialize["relationships"] = o.Relationships
 	}
@@ -179,7 +146,6 @@ func (o AttachJiraIssueRequestData) MarshalJSON() ([]byte, error) {
 func (o *AttachJiraIssueRequestData) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
 		Attributes    *AttachJiraIssueRequestDataAttributes    `json:"attributes,omitempty"`
-		Id            *string                                  `json:"id,omitempty"`
 		Relationships *AttachJiraIssueRequestDataRelationships `json:"relationships,omitempty"`
 		Type          *JiraIssuesDataType                      `json:"type"`
 	}{}
@@ -191,7 +157,7 @@ func (o *AttachJiraIssueRequestData) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"attributes", "id", "relationships", "type"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"attributes", "relationships", "type"})
 	} else {
 		return err
 	}
@@ -201,7 +167,6 @@ func (o *AttachJiraIssueRequestData) UnmarshalJSON(bytes []byte) (err error) {
 		hasInvalidField = true
 	}
 	o.Attributes = all.Attributes
-	o.Id = all.Id
 	if all.Relationships != nil && all.Relationships.UnparsedObject != nil && o.UnparsedObject == nil {
 		hasInvalidField = true
 	}

api/datadogV2/model_attach_jira_issue_request_data.go

@@ -12,7 +12,7 @@ import (
 
 // AttachJiraIssueRequestDataAttributes Attributes of the Jira issue to attach security findings to.
 type AttachJiraIssueRequestDataAttributes struct {
-	// The URL of the Jira issue to attach security findings to.
+	// URL of the Jira issue to attach security findings to.
 	JiraIssueUrl string `json:"jira_issue_url"`
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
 	UnparsedObject       map[string]interface{} `json:"-"`

api/datadogV2/model_attach_jira_issue_request_data_attributes.go

@@ -10,11 +10,11 @@ import (
 
 // CaseInsightsItems An insight of the case.
 type CaseInsightsItems struct {
-	// The reference of the insight.
+	// Reference of the insight.
 	Ref *string `json:"ref,omitempty"`
-	// The unique identifier of the resource. For example, the unique identifier of a security finding.
+	// Unique identifier of the resource. For example, the unique identifier of a security finding.
 	ResourceId *string `json:"resource_id,omitempty"`
-	// The type of the resource. For example, the type of a security finding is "SECURITY_FINDING".
+	// Type of the resource. For example, the type of a security finding is "SECURITY_FINDING".
 	Type *string `json:"type,omitempty"`
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
 	UnparsedObject       map[string]interface{} `json:"-"`

api/datadogV2/model_case_insights_items.go

@@ -12,7 +12,7 @@ import (
 
 // CaseManagementProjectData
 type CaseManagementProjectData struct {
-	// The unique identifier of the case management project.
+	// Unique identifier of the case management project.
 	Id string `json:"id"`
 	// Projects resource type.
 	Type CaseManagementProjectDataType `json:"type"`

api/datadogV2/model_case_management_project_data.go

@@ -14,8 +14,6 @@ import (
 type CreateCaseRequestData struct {
 	// Attributes of the case to create.
 	Attributes *CreateCaseRequestDataAttributes `json:"attributes,omitempty"`
-	// The unique identifier of the case.
-	Id *string `json:"id,omitempty"`
 	// Relationships of the case to create.
 	Relationships *CreateCaseRequestDataRelationships `json:"relationships,omitempty"`
 	// Cases resource type.
@@ -73,34 +71,6 @@ func (o *CreateCaseRequestData) SetAttributes(v CreateCaseRequestDataAttributes)
 	o.Attributes = &v
 }
 
-// GetId returns the Id field value if set, zero value otherwise.
-func (o *CreateCaseRequestData) GetId() string {
-	if o == nil || o.Id == nil {
-		var ret string
-		return ret
-	}
-	return *o.Id
-}
-
-// GetIdOk returns a tuple with the Id field value if set, nil otherwise
-// and a boolean to check if the value has been set.
-func (o *CreateCaseRequestData) GetIdOk() (*string, bool) {
-	if o == nil || o.Id == nil {
-		return nil, false
-	}
-	return o.Id, true
-}
-
-// HasId returns a boolean if a field has been set.
-func (o *CreateCaseRequestData) HasId() bool {
-	return o != nil && o.Id != nil
-}
-
-// SetId gets a reference to the given string and assigns it to the Id field.
-func (o *CreateCaseRequestData) SetId(v string) {
-	o.Id = &v
-}
-
 // GetRelationships returns the Relationships field value if set, zero value otherwise.
 func (o *CreateCaseRequestData) GetRelationships() CreateCaseRequestDataRelationships {
 	if o == nil || o.Relationships == nil {
@@ -161,9 +131,6 @@ func (o CreateCaseRequestData) MarshalJSON() ([]byte, error) {
 	if o.Attributes != nil {
 		toSerialize["attributes"] = o.Attributes
 	}
-	if o.Id != nil {
-		toSerialize["id"] = o.Id
-	}
 	if o.Relationships != nil {
 		toSerialize["relationships"] = o.Relationships
 	}
@@ -179,7 +146,6 @@ func (o CreateCaseRequestData) MarshalJSON() ([]byte, error) {
 func (o *CreateCaseRequestData) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
 		Attributes    *CreateCaseRequestDataAttributes    `json:"attributes,omitempty"`
-		Id            *string                             `json:"id,omitempty"`
 		Relationships *CreateCaseRequestDataRelationships `json:"relationships,omitempty"`
 		Type          *CaseDataType                       `json:"type"`
 	}{}
@@ -191,7 +157,7 @@ func (o *CreateCaseRequestData) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"attributes", "id", "relationships", "type"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"attributes", "relationships", "type"})
 	} else {
 		return err
 	}
@@ -201,7 +167,6 @@ func (o *CreateCaseRequestData) UnmarshalJSON(bytes []byte) (err error) {
 		hasInvalidField = true
 	}
 	o.Attributes = all.Attributes
-	o.Id = all.Id
 	if all.Relationships != nil && all.Relationships.UnparsedObject != nil && o.UnparsedObject == nil {
 		hasInvalidField = true
 	}

api/datadogV2/model_create_case_request_data.go

@@ -10,13 +10,13 @@ import (
 
 // CreateCaseRequestDataAttributes Attributes of the case to create.
 type CreateCaseRequestDataAttributes struct {
-	// The unique identifier of the user assigned to the case.
+	// Unique identifier of the user assigned to the case.
 	AssigneeId *string `json:"assignee_id,omitempty"`
-	// The description of the case. If not provided, the description will be automatically generated.
+	// Description of the case. If not provided, the description will be automatically generated.
 	Description *string `json:"description,omitempty"`
 	// Case priority
 	Priority *CasePriority `json:"priority,omitempty"`
-	// The title of the case. If not provided, the title will be automatically generated.
+	// Title of the case. If not provided, the title will be automatically generated.
 	Title *string `json:"title,omitempty"`
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
 	UnparsedObject       map[string]interface{} `json:"-"`

api/datadogV2/model_create_case_request_data_attributes.go

@@ -14,8 +14,6 @@ import (
 type CreateJiraIssueRequestArray struct {
 	//
 	Data []CreateJiraIssueRequestData `json:"data"`
-	//
-	Included []CreateJiraIssueRequestArrayIncluded `json:"included,omitempty"`
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
 	UnparsedObject       map[string]interface{} `json:"-"`
 	AdditionalProperties map[string]interface{} `json:"-"`
@@ -62,44 +60,13 @@ func (o *CreateJiraIssueRequestArray) SetData(v []CreateJiraIssueRequestData) {
 	o.Data = v
 }
 
-// GetIncluded returns the Included field value if set, zero value otherwise.
-func (o *CreateJiraIssueRequestArray) GetIncluded() []CreateJiraIssueRequestArrayIncluded {
-	if o == nil || o.Included == nil {
-		var ret []CreateJiraIssueRequestArrayIncluded
-		return ret
-	}
-	return o.Included
-}
-
-// GetIncludedOk returns a tuple with the Included field value if set, nil otherwise
-// and a boolean to check if the value has been set.
-func (o *CreateJiraIssueRequestArray) GetIncludedOk() (*[]CreateJiraIssueRequestArrayIncluded, bool) {
-	if o == nil || o.Included == nil {
-		return nil, false
-	}
-	return &o.Included, true
-}
-
-// HasIncluded returns a boolean if a field has been set.
-func (o *CreateJiraIssueRequestArray) HasIncluded() bool {
-	return o != nil && o.Included != nil
-}
-
-// SetIncluded gets a reference to the given []CreateJiraIssueRequestArrayIncluded and assigns it to the Included field.
-func (o *CreateJiraIssueRequestArray) SetIncluded(v []CreateJiraIssueRequestArrayIncluded) {
-	o.Included = v
-}
-
 // MarshalJSON serializes the struct using spec logic.
 func (o CreateJiraIssueRequestArray) MarshalJSON() ([]byte, error) {
 	toSerialize := map[string]interface{}{}
 	if o.UnparsedObject != nil {
 		return datadog.Marshal(o.UnparsedObject)
 	}
 	toSerialize["data"] = o.Data
-	if o.Included != nil {
-		toSerialize["included"] = o.Included
-	}
 
 	for key, value := range o.AdditionalProperties {
 		toSerialize[key] = value
@@ -110,8 +77,7 @@ func (o CreateJiraIssueRequestArray) MarshalJSON() ([]byte, error) {
 // UnmarshalJSON deserializes the given payload.
 func (o *CreateJiraIssueRequestArray) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
-		Data     *[]CreateJiraIssueRequestData         `json:"data"`
-		Included []CreateJiraIssueRequestArrayIncluded `json:"included,omitempty"`
+		Data *[]CreateJiraIssueRequestData `json:"data"`
 	}{}
 	if err = datadog.Unmarshal(bytes, &all); err != nil {
 		return datadog.Unmarshal(bytes, &o.UnparsedObject)
@@ -121,12 +87,11 @@ func (o *CreateJiraIssueRequestArray) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"data", "included"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"data"})
 	} else {
 		return err
 	}
 	o.Data = *all.Data
-	o.Included = all.Included
 
 	if len(additionalProperties) > 0 {
 		o.AdditionalProperties = additionalProperties