Update

PUT v1/performance_policies/id

Description

Update attributes of a performance policy. Block size of a performance policy cannot be changed once the perfomance policy is created.

Normal Response Codes

200

HTTP Error Codes

400 401 403 404 409 500 503

Detail Codes

SM_incompatible_cache_policy

SM_invalid_arg_value

SM_invalid_path_variable

SM_invalid_query_param

SM_malformed_url

SM_missing_arg

SM_no_method_for_URL_pattern

SM_no_operation_found

SM_no_path_found

SM_perfpol_dedupe_unassigned_app_category

SM_perfpol_incompatible_app_category

SM_perfpol_invalid_app_category

SM_perfpol_oob

SM_perfpol_vol_move_app_category

SM_too_many

SM_unexpected_arg

SM_unexpected_query_param

SM_version_name

Request

Parameter Type JSON Type Description Mandatory Deprecated
id NsObjectID string Unique Identifier for the Performance Policy. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. true  
name NsPerfPolicyName string Name of the Performance Policy. String of up to 64 alphanumeric characters, - and . and : and space are allowed after first character. Example: 'SQL Server Logs'. false  
description NsDescription string Description of a performance policy. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. false  
compress NsBoolean boolean Flag denoting if data in the associated volume should be compressed. Possible values: 'true', 'false'. false  
cache NsBoolean boolean Flag denoting if data in the associated volume should be cached. Possible values: 'true', 'false'. false  
cache_policy NsCachePolicy string enum Specifies how data of associated volume should be cached. Supports two policies, 'normal' and 'aggressive'. 'normal' policy caches data but skips in certain conditions such as sequential I/O. 'aggressive' policy will accelerate caching of all data belonging to this volume, regardless of sequentiality. Possible values: 'disabled', 'normal', 'aggressive', 'no_write', 'aggressive_read_no_write'. false  
space_policy NsSpacePolicy string enum Specifies the state of the volume upon space constraint violation such as volume limit violation, snapshot limit violation, volumes above their volume reserve or snapshot reserve if the pool free space is exhausted. Supports two policies, 'offline' and 'non_writable'. Possible values: 'invalid', 'offline', 'non_writable', 'read_only', 'login_only'. false  
app_category NsString string Specifies the application category of the associated volume. Plain string. false  
dedupe_enabled NsBoolean boolean Specifies if dedupe is enabled for volumes created with this performance policy. Possible values: 'true', 'false'. false  

JSON Request


            

{
   "data" : {
      "space_policy" : "offline",
      "compress" : true,
      "cache_policy" : "normal",
      "name" : "perfpolicy0.08968002180541031",
      "description" : "azHpmALV5PIIScHTFj6QADsAJn5mZsDKL0EC1HXS06JB1B86Lv65u8c6NM9D5K74",
      "cache" : true
   }
}

        
         

Response

Parameter Type JSON Type Description Deprecated
id NsObjectID string Unique Identifier for the Performance Policy. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
name NsPerfPolicyName string Name of the Performance Policy. String of up to 64 alphanumeric characters, - and . and : and space are allowed after first character. Example: 'SQL Server Logs'.  
full_name NsPerfPolicyName string Fully qualified name of the Performance Policy. String of up to 64 alphanumeric characters, - and . and : and space are allowed after first character. Example: 'SQL Server Logs'.  
search_name NsSearchName string Name of the Performance Policy used for object search. Alphanumeric string, up to 64 characters including hyphen, period, colon. Example: 'vol:1'.  
description NsDescription string Description of a performance policy. String of up to 255 printable ASCII characters. Example: '99.9999% availability'.  
block_size NsUnsignedLong number Block Size in bytes to be used by the volumes created with this specific performance policy. Supported block sizes are 4096 bytes (4 KB), 8192 bytes (8 KB), 16384 bytes(16 KB), and 32768 bytes (32 KB). Block size of a performance policy cannot be changed once the performance policy is created. Unsigned 64-bit integer. Example: 1234.  
compress NsBoolean boolean Flag denoting if data in the associated volume should be compressed. Possible values: 'true', 'false'.  
cache NsBoolean boolean Flag denoting if data in the associated volume should be cached. Possible values: 'true', 'false'.  
cache_policy NsCachePolicy string enum Specifies how data of associated volume should be cached. Supports two policies, 'normal' and 'aggressive'. 'normal' policy caches data but skips in certain conditions such as sequential I/O. 'aggressive' policy will accelerate caching of all data belonging to this volume, regardless of sequentiality. Possible values: 'disabled', 'normal', 'aggressive', 'no_write', 'aggressive_read_no_write'.  
space_policy NsSpacePolicy string enum Specifies the state of the volume upon space constraint violation such as volume limit violation, snapshot limit violation, volumes above their volume reserve or snapshot reserve if the pool free space is exhausted. Supports two policies, 'offline' and 'non_writable'. Possible values: 'invalid', 'offline', 'non_writable', 'read_only', 'login_only'.  
app_category NsString string Specifies the application category of the associated volume. Plain string.  
dedupe_enabled NsBoolean boolean Specifies if dedupe is enabled for volumes created with this performance policy. Possible values: 'true', 'false'.  
deprecated NsBoolean boolean Specifies if this performance policy is deprecated. Possible values: 'true', 'false'.  
predefined NsBoolean boolean Specifies if this performance policy is predefined (read-only). Possible values: 'true', 'false'.  
creation_time NsTime number Time when the performance policy was created. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
last_modified NsTime number Time when the performance policy's configurations were last modified. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  

JSON Response


            

{
   "data" : {
      "search_name" : "perfpolicy0.08968002180541031",
      "block_size" : 8192,
      "name" : "perfpolicy0.08968002180541031",
      "last_modified" : 1426776454,
      "full_name" : "perfpolicy0.08968002180541031",
      "description" : "azHpmALV5PIIScHTFj6QADsAJn5mZsDKL0EC1HXS06JB1B86Lv65u8c6NM9D5K74",
      "space_policy" : "offline",
      "cache_policy" : "normal",
      "compress" : true,
      "creation_time" : 1426776453,
      "id" : "0300000000000004d3000000000000000000000013",
      "cache" : true
   }
}