Add receives_permissions_from field to Roles API (DataDog#3696)

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

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

.generator/schemas/v2/openapi.yaml

@@ -49931,6 +49931,18 @@ components:
           description: The name of the role. The name is neither unique nor a stable
             identifier of the role.
           type: string
+        receives_permissions_from:
+          description: 'The managed role from which this role automatically inherits
+            new permissions.
+
+            Specify one of the following: "Datadog Admin Role", "Datadog Standard
+            Role", or "Datadog Read Only Role".
+
+            If empty or not specified, the role does not automatically inherit permissions
+            from any managed role.'
+          items:
+            type: string
+          type: array
         user_count:
           description: Number of users with that role.
           format: int64
@@ -49956,6 +49968,18 @@ components:
           description: Name of the new role that is cloned.
           example: cloned-role
           type: string
+        receives_permissions_from:
+          description: 'The managed role from which this role automatically inherits
+            new permissions.
+
+            Specify one of the following: "Datadog Admin Role", "Datadog Standard
+            Role", or "Datadog Read Only Role".
+
+            If empty or not specified, the role does not automatically inherit permissions
+            from any managed role.'
+          items:
+            type: string
+          type: array
       required:
       - name
       type: object
@@ -49984,6 +50008,18 @@ components:
           description: Name of the role.
           example: developers
           type: string
+        receives_permissions_from:
+          description: 'The managed role from which this role automatically inherits
+            new permissions.
+
+            Specify one of the following: "Datadog Admin Role", "Datadog Standard
+            Role", or "Datadog Read Only Role".
+
+            If empty or not specified, the role does not automatically inherit permissions
+            from any managed role.'
+          items:
+            type: string
+          type: array
       required:
       - name
       type: object
@@ -50105,6 +50141,18 @@ components:
         name:
           description: Name of the role.
           type: string
+        receives_permissions_from:
+          description: 'The managed role from which this role automatically inherits
+            new permissions.
+
+            Specify one of the following: "Datadog Admin Role", "Datadog Standard
+            Role", or "Datadog Read Only Role".
+
+            If empty or not specified, the role does not automatically inherit permissions
+            from any managed role.'
+          items:
+            type: string
+          type: array
         user_count:
           description: The user count.
           format: int32
@@ -105571,7 +105619,12 @@ tags:
 
     read access on a specific log index to a role can be done in Datadog from the
 
-    [Pipelines page](https://app.datadoghq.com/logs/pipelines).'
+    [Pipelines page](https://app.datadoghq.com/logs/pipelines).
+
+
+    Roles can also be managed in bulk through the Datadog UI, which provides
+
+    the capability to assign a single permission to multiple roles simultaneously.'
   name: Roles
 - description: Auto-generated tag Rum Audience Management
   name: Rum Audience Management

api/datadogV2/model_role_attributes.go

@@ -18,6 +18,10 @@ type RoleAttributes struct {
 	ModifiedAt *time.Time `json:"modified_at,omitempty"`
 	// The name of the role. The name is neither unique nor a stable identifier of the role.
 	Name *string `json:"name,omitempty"`
+	// The managed role from which this role automatically inherits new permissions.
+	// Specify one of the following: "Datadog Admin Role", "Datadog Standard Role", or "Datadog Read Only Role".
+	// If empty or not specified, the role does not automatically inherit permissions from any managed role.
+	ReceivesPermissionsFrom []string `json:"receives_permissions_from,omitempty"`
 	// Number of users with that role.
 	UserCount *int64 `json:"user_count,omitempty"`
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
@@ -126,6 +130,34 @@ func (o *RoleAttributes) SetName(v string) {
 	o.Name = &v
 }
 
+// GetReceivesPermissionsFrom returns the ReceivesPermissionsFrom field value if set, zero value otherwise.
+func (o *RoleAttributes) GetReceivesPermissionsFrom() []string {
+	if o == nil || o.ReceivesPermissionsFrom == nil {
+		var ret []string
+		return ret
+	}
+	return o.ReceivesPermissionsFrom
+}
+
+// GetReceivesPermissionsFromOk returns a tuple with the ReceivesPermissionsFrom field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *RoleAttributes) GetReceivesPermissionsFromOk() (*[]string, bool) {
+	if o == nil || o.ReceivesPermissionsFrom == nil {
+		return nil, false
+	}
+	return &o.ReceivesPermissionsFrom, true
+}
+
+// HasReceivesPermissionsFrom returns a boolean if a field has been set.
+func (o *RoleAttributes) HasReceivesPermissionsFrom() bool {
+	return o != nil && o.ReceivesPermissionsFrom != nil
+}
+
+// SetReceivesPermissionsFrom gets a reference to the given []string and assigns it to the ReceivesPermissionsFrom field.
+func (o *RoleAttributes) SetReceivesPermissionsFrom(v []string) {
+	o.ReceivesPermissionsFrom = v
+}
+
 // GetUserCount returns the UserCount field value if set, zero value otherwise.
 func (o *RoleAttributes) GetUserCount() int64 {
 	if o == nil || o.UserCount == nil {
@@ -177,6 +209,9 @@ func (o RoleAttributes) MarshalJSON() ([]byte, error) {
 	if o.Name != nil {
 		toSerialize["name"] = o.Name
 	}
+	if o.ReceivesPermissionsFrom != nil {
+		toSerialize["receives_permissions_from"] = o.ReceivesPermissionsFrom
+	}
 	if o.UserCount != nil {
 		toSerialize["user_count"] = o.UserCount
 	}
@@ -190,23 +225,25 @@ func (o RoleAttributes) MarshalJSON() ([]byte, error) {
 // UnmarshalJSON deserializes the given payload.
 func (o *RoleAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
-		CreatedAt  *time.Time `json:"created_at,omitempty"`
-		ModifiedAt *time.Time `json:"modified_at,omitempty"`
-		Name       *string    `json:"name,omitempty"`
-		UserCount  *int64     `json:"user_count,omitempty"`
+		CreatedAt               *time.Time `json:"created_at,omitempty"`
+		ModifiedAt              *time.Time `json:"modified_at,omitempty"`
+		Name                    *string    `json:"name,omitempty"`
+		ReceivesPermissionsFrom []string   `json:"receives_permissions_from,omitempty"`
+		UserCount               *int64     `json:"user_count,omitempty"`
 	}{}
 	if err = datadog.Unmarshal(bytes, &all); err != nil {
 		return datadog.Unmarshal(bytes, &o.UnparsedObject)
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"created_at", "modified_at", "name", "user_count"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"created_at", "modified_at", "name", "receives_permissions_from", "user_count"})
 	} else {
 		return err
 	}
 	o.CreatedAt = all.CreatedAt
 	o.ModifiedAt = all.ModifiedAt
 	o.Name = all.Name
+	o.ReceivesPermissionsFrom = all.ReceivesPermissionsFrom
 	o.UserCount = all.UserCount
 
 	if len(additionalProperties) > 0 {

api/datadogV2/model_role_clone_attributes.go

@@ -14,6 +14,10 @@ import (
 type RoleCloneAttributes struct {
 	// Name of the new role that is cloned.
 	Name string `json:"name"`
+	// The managed role from which this role automatically inherits new permissions.
+	// Specify one of the following: "Datadog Admin Role", "Datadog Standard Role", or "Datadog Read Only Role".
+	// If empty or not specified, the role does not automatically inherit permissions from any managed role.
+	ReceivesPermissionsFrom []string `json:"receives_permissions_from,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:"-"`
@@ -60,13 +64,44 @@ func (o *RoleCloneAttributes) SetName(v string) {
 	o.Name = v
 }
 
+// GetReceivesPermissionsFrom returns the ReceivesPermissionsFrom field value if set, zero value otherwise.
+func (o *RoleCloneAttributes) GetReceivesPermissionsFrom() []string {
+	if o == nil || o.ReceivesPermissionsFrom == nil {
+		var ret []string
+		return ret
+	}
+	return o.ReceivesPermissionsFrom
+}
+
+// GetReceivesPermissionsFromOk returns a tuple with the ReceivesPermissionsFrom field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *RoleCloneAttributes) GetReceivesPermissionsFromOk() (*[]string, bool) {
+	if o == nil || o.ReceivesPermissionsFrom == nil {
+		return nil, false
+	}
+	return &o.ReceivesPermissionsFrom, true
+}
+
+// HasReceivesPermissionsFrom returns a boolean if a field has been set.
+func (o *RoleCloneAttributes) HasReceivesPermissionsFrom() bool {
+	return o != nil && o.ReceivesPermissionsFrom != nil
+}
+
+// SetReceivesPermissionsFrom gets a reference to the given []string and assigns it to the ReceivesPermissionsFrom field.
+func (o *RoleCloneAttributes) SetReceivesPermissionsFrom(v []string) {
+	o.ReceivesPermissionsFrom = v
+}
+
 // MarshalJSON serializes the struct using spec logic.
 func (o RoleCloneAttributes) MarshalJSON() ([]byte, error) {
 	toSerialize := map[string]interface{}{}
 	if o.UnparsedObject != nil {
 		return datadog.Marshal(o.UnparsedObject)
 	}
 	toSerialize["name"] = o.Name
+	if o.ReceivesPermissionsFrom != nil {
+		toSerialize["receives_permissions_from"] = o.ReceivesPermissionsFrom
+	}
 
 	for key, value := range o.AdditionalProperties {
 		toSerialize[key] = value
@@ -77,7 +112,8 @@ func (o RoleCloneAttributes) MarshalJSON() ([]byte, error) {
 // UnmarshalJSON deserializes the given payload.
 func (o *RoleCloneAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
-		Name *string `json:"name"`
+		Name                    *string  `json:"name"`
+		ReceivesPermissionsFrom []string `json:"receives_permissions_from,omitempty"`
 	}{}
 	if err = datadog.Unmarshal(bytes, &all); err != nil {
 		return datadog.Unmarshal(bytes, &o.UnparsedObject)
@@ -87,11 +123,12 @@ func (o *RoleCloneAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"name"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"name", "receives_permissions_from"})
 	} else {
 		return err
 	}
 	o.Name = *all.Name
+	o.ReceivesPermissionsFrom = all.ReceivesPermissionsFrom
 
 	if len(additionalProperties) > 0 {
 		o.AdditionalProperties = additionalProperties

api/datadogV2/model_role_create_attributes.go

@@ -19,6 +19,10 @@ type RoleCreateAttributes struct {
 	ModifiedAt *time.Time `json:"modified_at,omitempty"`
 	// Name of the role.
 	Name string `json:"name"`
+	// The managed role from which this role automatically inherits new permissions.
+	// Specify one of the following: "Datadog Admin Role", "Datadog Standard Role", or "Datadog Read Only Role".
+	// If empty or not specified, the role does not automatically inherit permissions from any managed role.
+	ReceivesPermissionsFrom []string `json:"receives_permissions_from,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:"-"`
@@ -121,6 +125,34 @@ func (o *RoleCreateAttributes) SetName(v string) {
 	o.Name = v
 }
 
+// GetReceivesPermissionsFrom returns the ReceivesPermissionsFrom field value if set, zero value otherwise.
+func (o *RoleCreateAttributes) GetReceivesPermissionsFrom() []string {
+	if o == nil || o.ReceivesPermissionsFrom == nil {
+		var ret []string
+		return ret
+	}
+	return o.ReceivesPermissionsFrom
+}
+
+// GetReceivesPermissionsFromOk returns a tuple with the ReceivesPermissionsFrom field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *RoleCreateAttributes) GetReceivesPermissionsFromOk() (*[]string, bool) {
+	if o == nil || o.ReceivesPermissionsFrom == nil {
+		return nil, false
+	}
+	return &o.ReceivesPermissionsFrom, true
+}
+
+// HasReceivesPermissionsFrom returns a boolean if a field has been set.
+func (o *RoleCreateAttributes) HasReceivesPermissionsFrom() bool {
+	return o != nil && o.ReceivesPermissionsFrom != nil
+}
+
+// SetReceivesPermissionsFrom gets a reference to the given []string and assigns it to the ReceivesPermissionsFrom field.
+func (o *RoleCreateAttributes) SetReceivesPermissionsFrom(v []string) {
+	o.ReceivesPermissionsFrom = v
+}
+
 // MarshalJSON serializes the struct using spec logic.
 func (o RoleCreateAttributes) MarshalJSON() ([]byte, error) {
 	toSerialize := map[string]interface{}{}
@@ -142,6 +174,9 @@ func (o RoleCreateAttributes) MarshalJSON() ([]byte, error) {
 		}
 	}
 	toSerialize["name"] = o.Name
+	if o.ReceivesPermissionsFrom != nil {
+		toSerialize["receives_permissions_from"] = o.ReceivesPermissionsFrom
+	}
 
 	for key, value := range o.AdditionalProperties {
 		toSerialize[key] = value
@@ -152,9 +187,10 @@ func (o RoleCreateAttributes) MarshalJSON() ([]byte, error) {
 // UnmarshalJSON deserializes the given payload.
 func (o *RoleCreateAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
-		CreatedAt  *time.Time `json:"created_at,omitempty"`
-		ModifiedAt *time.Time `json:"modified_at,omitempty"`
-		Name       *string    `json:"name"`
+		CreatedAt               *time.Time `json:"created_at,omitempty"`
+		ModifiedAt              *time.Time `json:"modified_at,omitempty"`
+		Name                    *string    `json:"name"`
+		ReceivesPermissionsFrom []string   `json:"receives_permissions_from,omitempty"`
 	}{}
 	if err = datadog.Unmarshal(bytes, &all); err != nil {
 		return datadog.Unmarshal(bytes, &o.UnparsedObject)
@@ -164,13 +200,14 @@ func (o *RoleCreateAttributes) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	additionalProperties := make(map[string]interface{})
 	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
-		datadog.DeleteKeys(additionalProperties, &[]string{"created_at", "modified_at", "name"})
+		datadog.DeleteKeys(additionalProperties, &[]string{"created_at", "modified_at", "name", "receives_permissions_from"})
 	} else {
 		return err
 	}
 	o.CreatedAt = all.CreatedAt
 	o.ModifiedAt = all.ModifiedAt
 	o.Name = *all.Name
+	o.ReceivesPermissionsFrom = all.ReceivesPermissionsFrom
 
 	if len(additionalProperties) > 0 {
 		o.AdditionalProperties = additionalProperties