document v2 stable mcnulty-web-py3 endpoints (#3891)

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

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

.generator/schemas/v2/openapi.yaml

@@ -840,11 +840,17 @@
 //   - [SyntheticsApi.DeleteSyntheticsSuites]
 //   - [SyntheticsApi.DeleteSyntheticsTests]
 //   - [SyntheticsApi.EditSyntheticsSuite]
+//   - [SyntheticsApi.GetApiMultistepSubtestParents]
+//   - [SyntheticsApi.GetApiMultistepSubtests]
 //   - [SyntheticsApi.GetOnDemandConcurrencyCap]
 //   - [SyntheticsApi.GetSyntheticsFastTestResult]
 //   - [SyntheticsApi.GetSyntheticsNetworkTest]
 //   - [SyntheticsApi.GetSyntheticsSuite]
+//   - [SyntheticsApi.GetSyntheticsTestVersion]
+//   - [SyntheticsApi.GetTestParentSuites]
+//   - [SyntheticsApi.ListSyntheticsTestVersions]
 //   - [SyntheticsApi.PatchGlobalVariable]
+//   - [SyntheticsApi.PatchTestSuite]
 //   - [SyntheticsApi.SearchSuites]
 //   - [SyntheticsApi.SetOnDemandConcurrencyCap]
 //   - [SyntheticsApi.UpdateSyntheticsNetworkTest]
@@ -908,6 +914,11 @@
 //   - [UsersApi.ListUsers]
 //   - [UsersApi.SendInvitations]
 //   - [UsersApi.UpdateUser]
+//   - [WidgetsApi.CreateWidget]
+//   - [WidgetsApi.DeleteWidget]
+//   - [WidgetsApi.GetWidget]
+//   - [WidgetsApi.SearchWidgets]
+//   - [WidgetsApi.UpdateWidget]
 //   - [WorkflowAutomationApi.CancelWorkflowInstance]
 //   - [WorkflowAutomationApi.CreateWorkflow]
 //   - [WorkflowAutomationApi.CreateWorkflowInstance]

api/datadogV2/api_synthetics.go

@@ -0,0 +1,110 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+package datadogV2
+
+import (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// CreateOrUpdateWidgetRequest Request body for creating or updating a widget.
+type CreateOrUpdateWidgetRequest struct {
+	// Data for creating or updating a widget.
+	Data CreateOrUpdateWidgetRequestData `json:"data"`
+	// 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:"-"`
+}
+
+// NewCreateOrUpdateWidgetRequest instantiates a new CreateOrUpdateWidgetRequest object.
+// This constructor will assign default values to properties that have it defined,
+// and makes sure properties required by API are set, but the set of arguments
+// will change when the set of required properties is changed.
+func NewCreateOrUpdateWidgetRequest(data CreateOrUpdateWidgetRequestData) *CreateOrUpdateWidgetRequest {
+	this := CreateOrUpdateWidgetRequest{}
+	this.Data = data
+	return &this
+}
+
+// NewCreateOrUpdateWidgetRequestWithDefaults instantiates a new CreateOrUpdateWidgetRequest object.
+// This constructor will only assign default values to properties that have it defined,
+// but it doesn't guarantee that properties required by API are set.
+func NewCreateOrUpdateWidgetRequestWithDefaults() *CreateOrUpdateWidgetRequest {
+	this := CreateOrUpdateWidgetRequest{}
+	return &this
+}
+
+// GetData returns the Data field value.
+func (o *CreateOrUpdateWidgetRequest) GetData() CreateOrUpdateWidgetRequestData {
+	if o == nil {
+		var ret CreateOrUpdateWidgetRequestData
+		return ret
+	}
+	return o.Data
+}
+
+// GetDataOk returns a tuple with the Data field value
+// and a boolean to check if the value has been set.
+func (o *CreateOrUpdateWidgetRequest) GetDataOk() (*CreateOrUpdateWidgetRequestData, bool) {
+	if o == nil {
+		return nil, false
+	}
+	return &o.Data, true
+}
+
+// SetData sets field value.
+func (o *CreateOrUpdateWidgetRequest) SetData(v CreateOrUpdateWidgetRequestData) {
+	o.Data = v
+}
+
+// MarshalJSON serializes the struct using spec logic.
+func (o CreateOrUpdateWidgetRequest) MarshalJSON() ([]byte, error) {
+	toSerialize := map[string]interface{}{}
+	if o.UnparsedObject != nil {
+		return datadog.Marshal(o.UnparsedObject)
+	}
+	toSerialize["data"] = o.Data
+
+	for key, value := range o.AdditionalProperties {
+		toSerialize[key] = value
+	}
+	return datadog.Marshal(toSerialize)
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (o *CreateOrUpdateWidgetRequest) UnmarshalJSON(bytes []byte) (err error) {
+	all := struct {
+		Data *CreateOrUpdateWidgetRequestData `json:"data"`
+	}{}
+	if err = datadog.Unmarshal(bytes, &all); err != nil {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+	if all.Data == nil {
+		return fmt.Errorf("required field data missing")
+	}
+	additionalProperties := make(map[string]interface{})
+	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
+		datadog.DeleteKeys(additionalProperties, &[]string{"data"})
+	} else {
+		return err
+	}
+
+	hasInvalidField := false
+	if all.Data.UnparsedObject != nil && o.UnparsedObject == nil {
+		hasInvalidField = true
+	}
+	o.Data = *all.Data
+
+	if len(additionalProperties) > 0 {
+		o.AdditionalProperties = additionalProperties
+	}
+
+	if hasInvalidField {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+
+	return nil
+}

api/datadogV2/api_widgets.go

@@ -0,0 +1,156 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+package datadogV2
+
+import (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// CreateOrUpdateWidgetRequestAttributes Attributes for creating or updating a widget.
+type CreateOrUpdateWidgetRequestAttributes struct {
+	// The definition of a widget, including its type and configuration.
+	Definition WidgetDefinition `json:"definition"`
+	// User-defined tags for organizing the widget.
+	Tags datadog.NullableList[string] `json:"tags,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:"-"`
+}
+
+// NewCreateOrUpdateWidgetRequestAttributes instantiates a new CreateOrUpdateWidgetRequestAttributes object.
+// This constructor will assign default values to properties that have it defined,
+// and makes sure properties required by API are set, but the set of arguments
+// will change when the set of required properties is changed.
+func NewCreateOrUpdateWidgetRequestAttributes(definition WidgetDefinition) *CreateOrUpdateWidgetRequestAttributes {
+	this := CreateOrUpdateWidgetRequestAttributes{}
+	this.Definition = definition
+	return &this
+}
+
+// NewCreateOrUpdateWidgetRequestAttributesWithDefaults instantiates a new CreateOrUpdateWidgetRequestAttributes object.
+// This constructor will only assign default values to properties that have it defined,
+// but it doesn't guarantee that properties required by API are set.
+func NewCreateOrUpdateWidgetRequestAttributesWithDefaults() *CreateOrUpdateWidgetRequestAttributes {
+	this := CreateOrUpdateWidgetRequestAttributes{}
+	return &this
+}
+
+// GetDefinition returns the Definition field value.
+func (o *CreateOrUpdateWidgetRequestAttributes) GetDefinition() WidgetDefinition {
+	if o == nil {
+		var ret WidgetDefinition
+		return ret
+	}
+	return o.Definition
+}
+
+// GetDefinitionOk returns a tuple with the Definition field value
+// and a boolean to check if the value has been set.
+func (o *CreateOrUpdateWidgetRequestAttributes) GetDefinitionOk() (*WidgetDefinition, bool) {
+	if o == nil {
+		return nil, false
+	}
+	return &o.Definition, true
+}
+
+// SetDefinition sets field value.
+func (o *CreateOrUpdateWidgetRequestAttributes) SetDefinition(v WidgetDefinition) {
+	o.Definition = v
+}
+
+// GetTags returns the Tags field value if set, zero value otherwise (both if not set or set to explicit null).
+func (o *CreateOrUpdateWidgetRequestAttributes) GetTags() []string {
+	if o == nil || o.Tags.Get() == nil {
+		var ret []string
+		return ret
+	}
+	return *o.Tags.Get()
+}
+
+// GetTagsOk returns a tuple with the Tags field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+// NOTE: If the value is an explicit nil, `nil, true` will be returned.
+func (o *CreateOrUpdateWidgetRequestAttributes) GetTagsOk() (*[]string, bool) {
+	if o == nil {
+		return nil, false
+	}
+	return o.Tags.Get(), o.Tags.IsSet()
+}
+
+// HasTags returns a boolean if a field has been set.
+func (o *CreateOrUpdateWidgetRequestAttributes) HasTags() bool {
+	return o != nil && o.Tags.IsSet()
+}
+
+// SetTags gets a reference to the given datadog.NullableList[string] and assigns it to the Tags field.
+func (o *CreateOrUpdateWidgetRequestAttributes) SetTags(v []string) {
+	o.Tags.Set(&v)
+}
+
+// SetTagsNil sets the value for Tags to be an explicit nil.
+func (o *CreateOrUpdateWidgetRequestAttributes) SetTagsNil() {
+	o.Tags.Set(nil)
+}
+
+// UnsetTags ensures that no value is present for Tags, not even an explicit nil.
+func (o *CreateOrUpdateWidgetRequestAttributes) UnsetTags() {
+	o.Tags.Unset()
+}
+
+// MarshalJSON serializes the struct using spec logic.
+func (o CreateOrUpdateWidgetRequestAttributes) MarshalJSON() ([]byte, error) {
+	toSerialize := map[string]interface{}{}
+	if o.UnparsedObject != nil {
+		return datadog.Marshal(o.UnparsedObject)
+	}
+	toSerialize["definition"] = o.Definition
+	if o.Tags.IsSet() {
+		toSerialize["tags"] = o.Tags.Get()
+	}
+
+	for key, value := range o.AdditionalProperties {
+		toSerialize[key] = value
+	}
+	return datadog.Marshal(toSerialize)
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (o *CreateOrUpdateWidgetRequestAttributes) UnmarshalJSON(bytes []byte) (err error) {
+	all := struct {
+		Definition *WidgetDefinition            `json:"definition"`
+		Tags       datadog.NullableList[string] `json:"tags,omitempty"`
+	}{}
+	if err = datadog.Unmarshal(bytes, &all); err != nil {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+	if all.Definition == nil {
+		return fmt.Errorf("required field definition missing")
+	}
+	additionalProperties := make(map[string]interface{})
+	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
+		datadog.DeleteKeys(additionalProperties, &[]string{"definition", "tags"})
+	} else {
+		return err
+	}
+
+	hasInvalidField := false
+	if all.Definition.UnparsedObject != nil && o.UnparsedObject == nil {
+		hasInvalidField = true
+	}
+	o.Definition = *all.Definition
+	o.Tags = all.Tags
+
+	if len(additionalProperties) > 0 {
+		o.AdditionalProperties = additionalProperties
+	}
+
+	if hasInvalidField {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+
+	return nil
+}