[Index]
Model ref.: device/skypeforbusinesshybrid/CsClsConfiguration
The full URL would include the host-proxy name: https://[host-proxy].
Variables are enclosed in square brackets.
{ "$schema": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "EtlFileRolloverSizeMB": { "__type_requested": "UInt32", "required": false, "description": "Maximum size (in megabytes) that at event trace log file can reach before a new file is created. The default value is 20.", "title": "EtlFileRolloverSizeMB", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "EtlFileRolloverSizeMB" }, "ScopeClass": { "__type_requested": "Microsoft.Rtc.Management.Core.ScopeClass", "required": false, "name": "ScopeClass", "title": "ScopeClass", "__type_mapping_type": "Unknown", "readonly": true, "type": "string", "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string" }, "Regions": { "__type_requested": "System.Collections.Generic.IList[Microsoft.Rtc.Management.WritableConfig.Settings.CentralizedLoggingConfig.Region]", "required": false, "description": "Collection of regions defined for the centralized logging configuration settings. Regions are defined using the New-CsClsRegion cmdlet.\nThis parameter is intended for use with Skype for Business Online.", "title": "Regions", "__type_mapping_type": "Unknown", "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "Regions" }, "Version": { "__type_requested": "String", "required": false, "description": "This parameter is reserved for internal Microsoft use.", "title": "Version", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "Version" }, "CacheFileLocalMaxDiskUsage": { "__type_requested": "UInt32", "required": false, "description": "Maximum amount of disk space (percentage) that can be used for the cache files. The default value is 80.", "title": "CacheFileLocalMaxDiskUsage", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "CacheFileLocalMaxDiskUsage" }, "CacheFileLocalRetentionPeriod": { "__type_requested": "UInt32", "required": false, "description": "Maximum number of days that cache files are retained locally. The default value is 14.", "title": "CacheFileLocalRetentionPeriod", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "CacheFileLocalRetentionPeriod" }, "SecurityGroups": { "__type_requested": "System.Collections.Generic.IList[Microsoft.Rtc.Management.WritableConfig.Settings.CentralizedLoggingConfig.SecurityGroup]", "required": false, "description": "Security groups who are allowed to access the log files.\nThis parameter is intended for use with Skype for Business Online.", "title": "SecurityGroups", "__type_mapping_type": "Unknown", "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "SecurityGroups" }, "Identity": { "__type_requested": "string", "required": true, "description": "Unique identifier for the centralized logging configuration settings to be created. Because these settings can only be created at the site scope, use syntax similar to this, with the prefix \"site:\" followed by the name of the site:\n-Identity \"site:Redmond\"", "title": "Identity", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "Identity" }, "CacheFileNetworkFolder": { "__type_requested": "String", "required": false, "description": "Full UNC path to the network cache folder. There is no default value.", "title": "CacheFileNetworkFolder", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "CacheFileNetworkFolder" }, "NetworkUsagePacketSize": { "__type_requested": "UInt32", "required": false, "description": "Packet size (in kilobytes) for transmitting agent search results and copying cache files over the network. The default value is 64 KB.", "title": "NetworkUsagePacketSize", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "NetworkUsagePacketSize" }, "Element": { "__type_requested": "System.Xml.Linq.XElement", "required": false, "name": "Element", "title": "Element", "__type_mapping_type": "Unknown", "readonly": true, "type": "string", "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string" }, "InMemory": { "__type_requested": "SwitchParameter", "required": false, "description": "Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet's matching Set- cmdlet.", "title": "InMemory", "__type_mapping_type": "Boolean", "readonly": false, "type": "boolean", "name": "InMemory" }, "MinimumClsAgentServiceVersion": { "__type_requested": "UInt32", "required": false, "description": "Specifies the minimum version of the centralized logging service agent to be used when logging data; any computers with an agent version lower than the minimum value will be excluded from the logging operations. The default value is 6, representing Skype for Business Server 2015. This parameter is intended for use with Skype for Business Online.", "title": "MinimumClsAgentServiceVersion", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "MinimumClsAgentServiceVersion" }, "Anchor": { "__type_requested": "Microsoft.Rtc.Management.Core.IScopeAnchor", "required": false, "name": "Anchor", "title": "Anchor", "__type_mapping_type": "Unknown", "readonly": true, "type": "string", "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string" }, "EtlFileRolloverMinutes": { "__type_requested": "UInt32", "required": false, "description": "Maximum amount of time (in minutes) that can elapse before a new event log trace file is created. (This new file will be created even if the existing trace file has not reached the specified rollover size.) The default value is 60.", "title": "EtlFileRolloverMinutes", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "EtlFileRolloverMinutes" }, "ComponentThrottleLimit": { "__type_requested": "UInt32", "required": false, "description": "Maximum rate at which a component is allowed to generate trace records before its tracing is throttled. The default value is 5000 trace calls per second.", "title": "ComponentThrottleLimit", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "ComponentThrottleLimit" }, "Scenarios": { "__type_requested": "System.Collections.Generic.IList[Microsoft.Rtc.Management.WritableConfig.Settings.CentralizedLoggingConfig.Scenario]", "required": false, "description": "Collection of components/situations that can be traced using centralized logging. Scenarios are managed using the CsClsScenario cmdlets.", "title": "Scenarios", "__type_mapping_type": "Unknown", "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "Scenarios" }, "CacheFileLocalFolders": { "__type_requested": "String", "required": false, "description": "One or more full paths to the local folders where the cache files will be stored. The default value is %TEMP%\\Tracing. If more than one path is specified, then separate them with semi-colons.", "title": "CacheFileLocalFolders", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "CacheFileLocalFolders" }, "TmfFileSearchPath": { "__type_requested": "String", "required": false, "description": "Search path for TMF (trace message format) files. TMF files convert binary trace messages to a human-readable format.", "title": "TmfFileSearchPath", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "TmfFileSearchPath" }, "SearchTerms": { "__type_requested": "System.Collections.Generic.IList[Microsoft.Rtc.Management.WritableConfig.Settings.CentralizedLoggingConfig.SearchTerm]", "required": false, "description": "Collection of terms that help determine the personally identifiable information available to technical support personnel who search the centralized logging files. Search terms are managed using the CsClsSearchTerm cmdlets.", "title": "SearchTerms", "__type_mapping_type": "Unknown", "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "SearchTerms" }, "ComponentThrottleSample": { "__type_requested": "UInt32", "required": false, "description": "Maximum number of times the ComponentThrottleLimit can be exceeded within a one minute interval. The default value is 3.", "title": "ComponentThrottleSample", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "ComponentThrottleSample" }, "NetworkUsageThreshold": { "__type_requested": "UInt32", "required": false, "description": "Bandwidth usage threshold (in MB per second) for transmitting agent search results and copying cache files over the network. The default value is 10.", "title": "NetworkUsageThreshold", "__type_mapping_type": "Integer", "readonly": false, "type": "integer", "name": "NetworkUsageThreshold" }, "EtlFileFolder": { "__type_requested": "String", "required": false, "description": "Full path to the folder where the event log trace files will be stored. The default value is %TEMP%\\Tracing. Note that %TEMP% is evaluated in the contents of the CLS Service so it actual expands to %WINDIR%\\ServiceProfiles\\NetworkService\\AppData\\Local", "title": "EtlFileFolder", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "EtlFileFolder" } }, "schema_version": "1150" }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the GUI Add form. | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/add/ |
|
The GUI Add form of device/skypeforbusinesshybrid/CsClsConfiguration as JSON |
The API call to the /add/ URL can only be made from a hierarchy that allows the model type to be added. The actions in the response shows the url for the POST API call to create an instance.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Create | POST | /api/device/skypeforbusinesshybrid/CsClsConfiguration/ | hierarchy=[hierarchy] |
|
tool/Transaction/[trans pkid]to inspect the created resource and its instance pkid.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk delete [pkid1],[pkid2]... | DELETE | /api/device/skypeforbusinesshybrid/CsClsConfiguration/ | hierarchy=[hierarchy] | {"hrefs":["/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid1]", "/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid2]", ...]} |
GET http://[host-proxy]/api/device/skypeforbusinesshybrid/CsClsConfiguration/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Bulk Modify | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/bulk_update/?schema=&schema_rules=true |
|
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk Modify | POST | /api/device/skypeforbusinesshybrid/CsClsConfiguration/bulk_update/ |
|
For example: {"data":{"name":"value"}, "meta":{}, "request_meta":{ "hrefs":["/api/v0/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid1]", "/api/v0/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid2]",...]}} |
GET http://[host-proxy]/api/device/skypeforbusinesshybrid/CsClsConfiguration/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move the instance with [pkid] to [target_hierarchy] | POST | /api/tool/DataMove/?model_type=device/skypeforbusinesshybrid/CsClsConfiguration |
|
{"hrefs": ["/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]"]} |
Bulk Move | POST | /api/tool/DataMove/?model_type=device/skypeforbusinesshybrid/CsClsConfiguration |
|
{"hrefs": ["/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid1]", "/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid2]",...]} |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Get a selected [export_format] of the schema and instances [pkid1], [pkid2],... of device/skypeforbusinesshybrid/CsClsConfiguration; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | POST | /api/device/skypeforbusinesshybrid/CsClsConfiguration/export/ |
|
{ "hrefs":["/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid1]", "/api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid2]",...]}} |
For export_format=json, the response is a time stamped zip file of data in JSON as in the system database. Item properties such as strings that are empty or Boolean values that are not set, are not included. The filename in the response is of the format as the example:
Content-Disposition: attachment; filename=export_2013-05-17_14:20:19.186444.json.zip Content-Language:en Content-Type:application/x-zip
For export_format=raw_xlsx, the response is a MS Excel spreadsheet with columns corresponding to the JSON format export and a response filename format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=xlsx, the response is a MS Excel spreadsheet, arranged by any Field Display Policies that apply. The columns correspond with those of a Bulk Load Template export sheet. The response filename format is:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_formatted_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
The XLSX format can be used to bulk load instances of device/skypeforbusinesshybrid/CsClsConfiguration and the JSON format can be used to import instances of device/skypeforbusinesshybrid/CsClsConfiguration.
GET http://[host-proxy]/api/device/skypeforbusinesshybrid/CsClsConfiguration/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a compressed format of the Bulk Load spreadsheet template for device/skypeforbusinesshybrid/CsClsConfiguration | POST | /api/device/skypeforbusinesshybrid/CsClsConfiguration/export_bulkload_template/ |
|
The response is an attachment of the format: filetype_bulkloadsheet.xlsx.gz |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Configuration Template | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Field Display Policy | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
List | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/ |
|
The device/skypeforbusinesshybrid/CsClsConfiguration schema and all instances as JSON. |
(The list will return 0 to 3 device/skypeforbusinesshybrid/CsClsConfiguration instances)
{ "operations": [ "move" ], "pagination": { "direction": "asc", "order_by": null, "maximum_limit": 2000, "skip": 0, "current": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/?skip=0&limit=3&order_by=None&direction=asc&traversal=default", "limit": 3, "total_limit": null, "total": 0 }, "meta": { "tags": [], "cached": true, "title": "", "business_key": {}, "schema_version": "1150", "references": { "device": [ { "pkid": "", "href": "" } ], "children": [], "parent": [ { "pkid": "6t0ggef2c0deab00hb595101", "href": "/api/data/HierarchyNode/6t0ggef2c0deab00hb595101" } ], "foreign_key": [] }, "actions": [ { "add": { "support_async": false, "class": "add", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/add/?hierarchy=[hierarchy]", "method": "GET", "title": "Add" } }, { "remove": { "support_async": true, "class": "delete", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/?hierarchy=[hierarchy]", "method": "DELETE", "title": "Delete" } }, { "bulk_update_form": { "support_async": false, "class": "update", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/bulk_update/?hierarchy=[hierarchy]&schema=&schema_rules=true", "method": "GET", "title": "Bulk Modify" } }, { "move": { "title": "Move", "support_async": true, "class": "move", "href": "/api/tool/DataMove/?hierarchy=[hierarchy]&model_type=device/skypeforbusinesshybrid/CsClsConfiguration", "method": "POST", "view": "/api/tool/DataMove/?auth_token=[authtoken] } }, { "export": { "title": "Export", "support_async": false, "submit": "payload", "class": "export", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/export/?hierarchy=[hierarchy]", "method": "POST", "view": "/api/view/ExportData/add/?auth_token=[authtoken] } }, { "export_bulkload_template": { "support_async": false, "class": "bulkload_template", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/export_bulkload_template/?hierarchy=[hierarchy]", "method": "POST", "title": "Export Bulk Load Template" } }, { "configuration_template": { "support_async": false, "class": "config", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/configuration_template/?hierarchy=[hierarchy]", "method": "GET", "title": "Configuration Template" } }, { "field_display_policy": { "support_async": false, "class": "display_policy", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/field_display_policy/?hierarchy=[hierarchy]", "method": "GET", "title": "Field Display Policy" } }, { "list": { "support_async": false, "class": "list", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/?hierarchy=[hierarchy]", "method": "GET", "title": "List" } }, { "help": { "support_async": false, "class": "help", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/help?hierarchy=[hierarchy]", "method": "GET", "title": "Help" } }, { "purge": { "support_async": false, "class": "purge", "href": "/api/device/skypeforbusinesshybrid/CsClsConfiguration/purge/?hierarchy=[hierarchy]", "method": "POST", "title": "Purge" } } ], "model_type": "device/skypeforbusinesshybrid/CsClsConfiguration", "model_specific_actions": [ "get", "list", "add", "remove", "update", "bulk_update_form", "clone", "configuration_template", "export", "export_bulkload_template", "field_display_policy", "help", "move" ], "summary_attrs": [ { "allow_filtering": true, "name": "hierarchy_friendly_name", "title": "Located At" } ], "api_version": "20.1.1", "tagged_versions": [] }, "resources": [] }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the on-line Help for device/skypeforbusinesshybrid/CsClsConfiguration. | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/help | hierarchy=[hierarchy] | On-line help of Model ref.: device/skypeforbusinesshybrid/CsClsConfiguration as HTML |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Modify | PUT | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/ | hierarchy=[hierarchy] | (For payload specification) |
For Bulk modification, refer to the Bulk Modify section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Delete | DELETE | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/ | hierarchy=[hierarchy] |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Clone instance with [pkid]. The schema rules are applied. | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/clone/?schema=&schema_rules=true |
|
A JSON payload with:
|
GET http://[host-proxy]/api/device/skypeforbusinesshybrid/CsClsConfiguration/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move | POST | /api/tool/DataMove/[pkid]/?model_type=device/skypeforbusinesshybrid/CsClsConfiguration | hierarchy=[hierarchy] | If payload required: |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a selected [export_format] of the schema and a single instance with [pkid] of device/skypeforbusinesshybrid/CsClsConfiguration; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/export/ |
|
The response is an attachment. Refer to the list below. |
For export_format=raw_xlsx, the response is a "raw" MS Excel spreadsheet with columns corresponding to the JSON format export and a response format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=xlsx, the response is a MS Excel spreadsheet, formatted to show all columns and a response format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_formatted_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=json, the response is a time stamped zip file of data in JSON and a response format:
Content-Disposition: attachment; filename=export_2013-05-17_14:20:19.186444.json.zip Content-Language:en Content-Type:application/x-zip
The XLSX format can be used to bulk load instances of device/skypeforbusinesshybrid/CsClsConfiguration and the JSON format can be used to import instances of device/skypeforbusinesshybrid/CsClsConfiguration.
For Bulk Export, refer to the Bulk Export section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/ | hierarchy=[hierarchy] | The device/skypeforbusinesshybrid/CsClsConfiguration instance with [pkid]. |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Help | GET | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for device/skypeforbusinesshybrid/CsClsConfiguration. |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Purge | POST | /api/device/skypeforbusinesshybrid/CsClsConfiguration/[pkid]/purge/ | hierarchy=[hierarchy] | If payload required: |