Modify a user group
PUT /usergroups/{usergroup_id}
Replaces a user group with new information.
Parameters
Name | Type | In | Required | Description |
---|---|---|---|---|
usergroup_id |
string |
path |
True |
ID of the user group
|
Request Body
Replaces the entire stored resource with the supplied JSON request body while preserving the key values that are not user-modifiable.
Name | Type | Required | Description |
---|---|---|---|
description |
string |
False |
JSON string containing the description of the user group. Defined values are: * Minimum length: 1 * Maximum length: 254 * This string is internally validated to prevent XSS, Unicode, directory traversal, and SQL-injection attacks. |
id |
string |
False |
Globally unique identifier of the resource. Defined values are:
|
isSystem |
string |
False |
Specifies if an object is system generated. Defined values are:
|
metadata |
False |
Metadata associated with the resource |
|
name |
string |
False |
JSON string containing a name for the user group. Defined values are:
|
ownerOrganizationId |
string |
False |
JSON string containing the ID of the organization. |
tags |
array[tags] |
False |
JSON array of tags (name/value pairs) representing metadata for the user group. |
type |
string |
True |
Media type of the resource. Defined values are:
|
version |
string |
True |
Version of the resource. Defined values are:
|
Example request
{
"description": "This tag represents NetApp Sales Territory",
"id": "666a3f38-d4fa-5b62-a391-a69029758d32",
"metadata": {
"createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269",
"creationTimestamp": "2022-10-06T20:58:16.305662Z",
"labels": [],
"modificationTimestamp": "2022-10-06T20:58:16.305662Z",
"modifiedBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
},
"name": "AcmeSystemsUSA",
"ownerOrganizationId": "6544af09-8036-51e4-b579-bd30cb07b269",
"type": "application/vnd.netapp.bxp.usergroup",
"version": "1.0"
}
Response
Status: 204, Indicates if the user group was updated.
Error
Status: 400, Bad request
Name | Type | Required | Description |
---|---|---|---|
correlationId |
string |
False |
Internal UUID representing the request or related trace ID |
detail |
string |
False |
Details about the problem |
invalidParams |
array[invalidParams] |
False |
List of invalid parameters |
status |
string |
True |
HTTP error code related to the problem |
title |
string |
True |
Title description of the problem |
type |
string |
True |
Content-type of this object |
Example error response
{
"detail": "The supplied query parameters are invalid.",
"status": "400",
"title": "Invalid query parameters",
"type": "https://bluexp.netapp.io/problems/1"
}
Error
Status: 401, Unauthorized
Name | Type | Required | Description |
---|---|---|---|
correlationId |
string |
False |
Internal UUID representing the request or related trace ID |
detail |
string |
False |
Details about the problem |
invalidParams |
array[invalidParams] |
False |
List of invalid parameters |
status |
string |
True |
HTTP error code related to the problem |
title |
string |
True |
Title description of the problem |
type |
string |
True |
Content-type of this object |
Example error response
{
"detail": "The request is missing the required bearer token.",
"status": "401",
"title": "Missing bearer token",
"type": "https://bluexp.netapp.io/problems/1"
}
Error
Status: 403, Forbidden
Name | Type | Required | Description |
---|---|---|---|
correlationId |
string |
False |
Internal UUID representing the request or related trace ID |
detail |
string |
False |
Details about the problem |
invalidParams |
array[invalidParams] |
False |
List of invalid parameters |
status |
string |
True |
HTTP error code related to the problem |
title |
string |
True |
Title description of the problem |
type |
string |
True |
Content-type of this object |
Example error response
{
"detail": "The requested operation isn't permitted.",
"status": "403",
"title": "Operation not permitted",
"type": "https://bluexp.netapp.io/problems/11"
}
Error
Status: 404, Not found
Name | Type | Required | Description |
---|---|---|---|
correlationId |
string |
False |
Internal UUID representing the request or related trace ID |
detail |
string |
False |
Details about the problem |
invalidParams |
array[invalidParams] |
False |
List of invalid parameters |
status |
string |
True |
HTTP error code related to the problem |
title |
string |
True |
Title description of the problem |
type |
string |
True |
Content-type of this object |
Example error response
{
"detail": "The collection specified in the request URI wasn't found.",
"status": "404",
"title": "Collection not found",
"type": "https://bluexp.netapp.io/problems/2"
}
Error
Status: 409, Conflict
Name | Type | Required | Description |
---|---|---|---|
correlationId |
string |
False |
Internal UUID representing the request or related trace ID |
detail |
string |
False |
Details about the problem |
invalidParams |
array[invalidParams] |
False |
List of invalid parameters |
status |
string |
True |
HTTP error code related to the problem |
title |
string |
True |
Title description of the problem |
type |
string |
True |
Content-type of this object |
Example error response
{
"detail": "The request body JSON contains a field that conflicts with an idempotent value.",
"status": "409",
"title": "JSON resource conflict",
"type": "https://bluexp.netapp.io/problems/10"
}
Definitions
See Definitions
type_bxp_label
Name/value pair
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
|
value |
string |
True |
type_bxp_metadata
Metadata associated with the resource
Name | Type | Required | Description |
---|---|---|---|
createdBy |
string |
False |
UUID of the user who created the resource. |
creationTimestamp |
string |
False |
Resource creation date |
labels |
array[type_bxp_label] |
False |
Array of name/value pairs representing additional information for the resource. |
modificationTimestamp |
string |
False |
Resource modification date. |
modifiedBy |
string |
False |
UUID of the user who modified the resource. |
invalidParams
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
Name of the invalid parameter |
reason |
string |
True |
Reason why the parameter is invalid |