Skip to main content

Modify an organization

Contributors

PUT /organizations/{organization_id}

Replaces the specified organization with new information.

Parameters

Name Type In Required Description

organization_id

string

path

True

ID of the organization.

  • example: 666a3f38-d4fa-5b62-a391-a69029758d32

Request Body

Replaces the entire stored organization 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 resource. 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:

  • Conforms to the UUIDv4 Schema

isSystem

string

False

Specifies if an object is system generated. Defined values are:

  • "true"

legacyId

string

False

Unique identifier as understood by the previous version of this service.

metadata

type_bxp_metadata

False

Metadata associated with the resource.

name

string

True

JSON string containing a name for the resource. Defined values are:

  • Minimum length: 1

  • Maximum length: 300

  • This string is internally validated to prevent XSS, Unicode, directory traversal, and SQL-injection attacks.

ownerOrganizationId

string

False

JSON string containing the ID of the organization.

parentId

string

False

JSON string containing the ID of the hierarchy.

rawId

string

False

JSON string containing the physical ID of the resource. It is the ID as defined by the system (a UUID, a string, or any other defined ID). For example, the UUID of an ONTAP cluster or the UUID of an application in Astra Control.

  • maxLength: 400

  • minLength: 1

resourceClass

string

True

JSON string containing the resource class. This field is for Accounts (tenancy) compatibility support.

resourceType

string

True

JSON string containing the resource type. This should be one of the allowed resource types, which should be in the resource types collection. These resource types are defined by the service applications and the BlueXP IAM system.

tags

array[tags]

False

JSON array of tags (name/value pairs) representing metadata for the resource.

type

string

True

Media type of the resource. Defined values are:

  • "application/vnd.netapp.bxp.resource"

version

string

True

Version of the resource. Defined values are:

  • "1.0"
Example request 
{
  "id": "666a3f38-d4fa-5b62-a391-a69029758d32",
  "name": "netapp",
  "resourceType": "organization",
  "tags": [
    {
      "internal:bxp:parentId": "777a3f38-d4fa-5b62-a391-a69029758d32"
    },
    {
      "internal:bxp:ancestors": "666a3f38-d4fa-5b62-a391-a69029758d32,777a3f38-d4fa-5b62-a391-a69029758d32,48edfd48-3fed-4ffd-9aff-303c7008df7f, 999a3f38-d4fa-5b62-a391-a69029758d32"
    },
    {
      "internal:bxp:crmId": "a1a6ddeb-2a15-4907-a801-9b9c3f40a7b7"
    },
    {
      "internal:bxp:cmatId": "2e007562-f061-4b18-b9bd-16ef3bde524b"
    }
  ],
  "type": "application/vnd.netapp.bxp.resource",
  "version": "1.0"
}

Response

Status: 204, Indicates if the organization was updated.

Error

Status: 400, Bad request
Name Type Required Description

correlationId

string

False

Internal UUID representing the request or trace ID related.

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 the 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 trace ID related.

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 the 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 trace ID related.

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 the 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 trace ID related.

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 the 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 trace ID related.

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 the 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.

tags Hash mapping strings to string

invalidParams

Name Type Required Description

name

string

True

Name of the invalid parameter.

reason

string

True

Reason why the parameter is invalid.