Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Doc 2708 api add api s to edit fin ops user permissions for accounts and policies #736

Conversation

mdcolombaninetapp
Copy link
Collaborator

@mdcolombaninetapp mdcolombaninetapp commented Feb 10, 2025

Jira Ticket

DOC-2708

Other

options

policies

get_user

update_user

@mdcolombaninetapp mdcolombaninetapp requested a review from a team as a code owner February 10, 2025 15:22
schema:
$ref: ../../../../commons/schemas/errorResponse.yaml
'500':
description: Internal error response. Please try again later.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Internal error response. Try again.

schema:
$ref: ../../../../commons/schemas/errorResponse.yaml
'403':
description: Forbidden error response. Not permitted to call this API.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Forbidden error response. You need permissions to call this API.

schema:
$ref: ../../../../commons/schemas/errorResponse.yaml
'500':
description: Internal error response. Please try again later.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Internal error response. Try again.

schema:
$ref: ../../../../commons/schemas/errorResponse.yaml
'403':
description: Forbidden error response. Not permitted to call this API.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Forbidden error response. You need permissions to call this API.

schema:
$ref: ../../../../commons/schemas/errorResponse.yaml
'403':
description: Forbidden error response. Not permitted to call this API.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Forbidden error response. You need permissions to call this API.

schema:
$ref: ../../../../commons/schemas/errorResponse.yaml
'500':
description: Internal error response. Please try again later.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Internal error response. Try again.

tags:
- Organizations
summary: Update FinOps Authorization For User
description: Update the FinOps authorization configuration for user.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update the FinOps authorization configuration for a user.
or
Update the FinOps authorization configuration for users.

properties:
id:
type: string
description: "Provider account's ID.\r\nThis is the unique as defined by the service provider (e.g. AWS, Azure)."
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Provider account ID. This is the unique ID from the service provider, such as AWS, Azure.

nullable: true
example: Test
additionalProperties: false
description: Represents a (cloud) provider account ID.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A cloud provider account ID.

nullable: true
example: Effective Cost
additionalProperties: false
description: Represents a FinOps cost type.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A FinOps cost type.

nullable: true
example: Billing Engine View All Only
additionalProperties: false
description: Represents a FinOps authorization policy.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A FinOps authorization policy.

type: string
- name: paginationSize
in: query
description: number of items to include in the response
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The number of items to include in the response.

type: integer
- name: paginationKey
in: query
description: key used to fetch the next page of items
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The key used to get the next page of items.

action:
$ref: listAction.yaml
additionalProperties: false
description: Represents the information for a cost type list modification.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The information for a cost type list modification.

- Add
- Remove
type: string
description: Represents an action for managing items in a list.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

An action for managing items in a list.

type: array
items:
$ref: costTypeRequestListModification.yaml
description: "List of cost types to add/remove.\r\nCost type apply to all accounts assigned to the user (regardless of how the user has access to the account).\r\nIf user already has an existing list of cost types, the requested actions will be applied to this existing \r\nlist unless AuthorizationService.Models.Apis.AuthConfigs.User.UserAuthConfigChanges.ResetCostTypes is true (which will clear all existing cost types first)."
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

List of cost types to add/remove.\r\nCost type applies to all accounts assigned to the user (regardless of how the user has access to the account).\r\nIf the user already has an existing list of cost types, the requested actions are applied to this existing \r\nlist unless AuthorizationService.Models.Apis.AuthConfigs.User.UserAuthConfigChanges.ResetCostTypes is true (which will clear all existing cost types first).

nullable: true
organizationId:
type: string
description: "ID of the target Spot organization where the authorization configuration should be applied.\r\nOptional: Defaults to the caller's current Spot organization.\r\nIf specified, the ID must be one of the following:\r\n- The caller's current Spot organization\r\n- A child Spot organization of the caller's current Spot organization."
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ID of the target Spot organization where the authorization configuration should be applied.\r\nOptional: Defaults to the caller's current Spot organization.\r\nIf specified, the ID must be one of these:\r\n- The caller's current Spot organization\r\n- A child Spot organization of the caller's current Spot organization

description: "List of policies to add/remove.\r\nIf user or group already has an existing list of policies, the requested actions will be applied to this existing \r\nlist unless AuthorizationService.Models.Apis.CommonAuthConfigChanges`1.ResetPolicies is true (which will clear all existing policies first)."
nullable: true
additionalProperties: false
description: Represents FinOps authorization changes that apply to a user.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The FinOps authorization changes for a user.

type: array
items:
$ref: authConfigPolicy.yaml
description: Auth policies assigned to this user.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Authorization policies assigned to this user.

authChanges:
$ref: userAuthConfigChanges.yaml
additionalProperties: false
description: Request to update the FinOps authorization config for a specific user.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Request to update the FinOps authorization configuration for a specific user.

afterChanges:
$ref: userAuthConfigResponseModel.yaml
additionalProperties: false
description: Represents the FinOps authorization configuration for a specific user (before and after changes). [kind/spotinst:cbi:authorization:user]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The FinOps authorization configuration for a specific user (before and after changes). [kind/spotinst:cbi:authorization:user]

type: array
items:
$ref: costTypeRequestListModification.yaml
description: "List of cost types to add/remove.\r\nCost type apply to all accounts assigned to the user (regardless of how the user has access to the account).\r\nIf user already has an existing list of cost types, the requested actions will be applied to this existing\r\nlist unless resetCostTypes is true (which will clear all existing cost types first)."
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

List of cost types to add/remove.\r\nCost type applies to all accounts assigned to the user (regardless of how the user has access to the account).\r\nIf the user already has an existing list of cost types, the requested actions are applied to this existing \r\nlist unless AuthorizationService.Models.Apis.AuthConfigs.User.UserAuthConfigChanges.ResetCostTypes is true (which will clear all existing cost types first).
@mdcolombaninetapp

@mdcolombaninetapp mdcolombaninetapp deleted the DOC-2708-API-add-API-s-to-Edit-FinOps-User-Permissions-for-Accounts-and-Policies branch February 13, 2025 14:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants