[Index]
Model ref.: device/skypeforbusiness/CsPartnerApplication
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": { "AuthToken": { "__type_requested": "Microsoft.Rtc.Management.WritableConfig.Settings.SSAuth.IAuthTokenChoice", "required": false, "name": "AuthToken", "title": "AuthToken", "__type_mapping_type": "Unknown", "readonly": true, "type": "string", "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string" }, "MetadataUrl": { "__type_requested": "String", "required": true, "description": "URL where the WS-FederationMetadata for the partner application is published. Partner applications use the metadata to agree on the types of tokens that will be exchanged as well the keys that will be used to sign these tokens.", "title": "MetadataUrl", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "MetadataUrl" }, "Realm": { "__type_requested": "String", "required": false, "description": "Server-to-server security container. By default, Skype for Business Server 2015uses your default SIP domain as its OAuth realm.", "title": "Realm", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "Realm" }, "Name": { "__type_requested": "string", "required": false, "name": "Name", "title": "Name", "__type_mapping_type": "String", "readonly": true, "type": "string" }, "UseOAuthServer": { "__type_requested": "SwitchParameter", "required": true, "description": "When present, indicates that the partner application will use one of the pre-authorized OAuth servers instead of a security token server built into the application itself.", "title": "UseOAuthServer", "__type_mapping_type": "Boolean", "readonly": false, "type": "boolean", "name": "UseOAuthServer" }, "ApplicationIdentifier": { "__type_requested": "String", "required": true, "description": "Unique identifier for the partner application. The ApplicationIdentifier is provided by the server application. You cannot use the ApplicationIdentifier parameter and the MetadataUrl parameter in the same command.", "title": "ApplicationIdentifier", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "ApplicationIdentifier" }, "Enabled": { "__type_requested": "$true | $false", "required": false, "description": "When set to True the partner application will be enabled and available for immediate use. The default value is True.", "title": "Enabled", "__type_mapping_type": "Boolean", "readonly": false, "type": "boolean", "name": "Enabled" }, "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" }, "CertificateFileData": { "__type_requested": "String", "required": true, "description": "Path to a certificate file that can be assigned to the partner application. For example:\n-CertificateFileData \"C:\\Certificates\\PartnerApplication.cer\"", "title": "CertificateFileData", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "CertificateFileData" }, "ApplicationTrustLevel": { "__type_requested": "Microsoft.Rtc.Management.WritableConfig.Settings.SSAuth.ApplicationTrustLevel", "required": true, "description": "Specifies the level of trust between Skype for Business Server 2015 and the partner application. Allowed values are:\n* Full -- The partner application is trusted to represent itself and to impersonate any user in the realm. This is the default value.\n* Application -- The partner application is trusted to represent itself within the realm. In order to impersonate a user, it must obtain consent through from a security token server.\n* User -- The partner application must obtain consent from a security token server in order to represent a user, and cannot represent itself.\nThe default value is Full.", "title": "ApplicationTrustLevel", "__type_mapping_type": "Unknown", "readonly": true, "__WARNING": "Unhandled and unknown upstream type, this attribute forced into a readonly string", "type": "string", "name": "ApplicationTrustLevel" }, "Tenant": { "__type_requested": "Guid", "required": false, "description": "Globally unique identifier (GUID) of the Skype for Business Online tenant account for which the new partner application is being created. For example:\n-Tenant \"38aad667-af54-4397-aaa7-e94c79ec2308\"\nYou can return the tenant ID for each of your tenants by running this command:\nGet-CsTenant | Select-Object DisplayName, TenantID", "title": "Tenant", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "Tenant" }, "CertificateRawData": { "__type_requested": "String", "required": true, "description": "Certificate (in Base64 encoded format) that can be assigned to the partner application. To read raw data from a certificate and then convert that data to the required format, use commands similar to these:\n$x = Get-Content \"C:\\Certificates\\PartnerApplication.cer\" -Encoding Byte\n$y = [Convert]::ToBase64String($x)\nYou can then use this syntax to assign the certificate data stored in the variable $y:\n-CertificateRawData $y", "title": "CertificateRawData", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "CertificateRawData" }, "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" }, "AcceptSecurityIdentifierInformation": { "__type_requested": "$true | $false", "required": false, "description": "When set to True ($True), security identifiers (SIDs) can be used for authentication purposes. The default value is False.", "title": "AcceptSecurityIdentifierInformation", "__type_mapping_type": "Boolean", "readonly": false, "type": "boolean", "name": "AcceptSecurityIdentifierInformation" }, "Identity": { "__type_requested": "System.String", "required": false, "description": "Unique identifier for the new partner application.", "title": "Identity", "__type_mapping_type": "String", "readonly": false, "type": "string", "name": "Identity" } }, "schema_version": "1150" }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the GUI Add form. | GET | /api/device/skypeforbusiness/CsPartnerApplication/add/ |
|
The GUI Add form of device/skypeforbusiness/CsPartnerApplication 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/skypeforbusiness/CsPartnerApplication/ | 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/skypeforbusiness/CsPartnerApplication/ | hierarchy=[hierarchy] | {"hrefs":["/api/device/skypeforbusiness/CsPartnerApplication/[pkid1]", "/api/device/skypeforbusiness/CsPartnerApplication/[pkid2]", ...]} |
GET http://[host-proxy]/api/device/skypeforbusiness/CsPartnerApplication/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Bulk Modify | GET | /api/device/skypeforbusiness/CsPartnerApplication/bulk_update/?schema=&schema_rules=true |
|
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk Modify | POST | /api/device/skypeforbusiness/CsPartnerApplication/bulk_update/ |
|
For example: {"data":{"name":"value"}, "meta":{}, "request_meta":{ "hrefs":["/api/v0/device/skypeforbusiness/CsPartnerApplication/[pkid1]", "/api/v0/device/skypeforbusiness/CsPartnerApplication/[pkid2]",...]}} |
GET http://[host-proxy]/api/device/skypeforbusiness/CsPartnerApplication/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move the instance with [pkid] to [target_hierarchy] | POST | /api/tool/DataMove/?model_type=device/skypeforbusiness/CsPartnerApplication |
|
{"hrefs": ["/api/device/skypeforbusiness/CsPartnerApplication/[pkid]"]} |
Bulk Move | POST | /api/tool/DataMove/?model_type=device/skypeforbusiness/CsPartnerApplication |
|
{"hrefs": ["/api/device/skypeforbusiness/CsPartnerApplication/[pkid1]", "/api/device/skypeforbusiness/CsPartnerApplication/[pkid2]",...]} |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Get a selected [export_format] of the schema and instances [pkid1], [pkid2],... of device/skypeforbusiness/CsPartnerApplication; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | POST | /api/device/skypeforbusiness/CsPartnerApplication/export/ |
|
{ "hrefs":["/api/device/skypeforbusiness/CsPartnerApplication/[pkid1]", "/api/device/skypeforbusiness/CsPartnerApplication/[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/skypeforbusiness/CsPartnerApplication and the JSON format can be used to import instances of device/skypeforbusiness/CsPartnerApplication.
GET http://[host-proxy]/api/device/skypeforbusiness/CsPartnerApplication/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a compressed format of the Bulk Load spreadsheet template for device/skypeforbusiness/CsPartnerApplication | POST | /api/device/skypeforbusiness/CsPartnerApplication/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/skypeforbusiness/CsPartnerApplication/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Field Display Policy | GET | /api/device/skypeforbusiness/CsPartnerApplication/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
List | GET | /api/device/skypeforbusiness/CsPartnerApplication/ |
|
The device/skypeforbusiness/CsPartnerApplication schema and all instances as JSON. |
(The list will return 0 to 3 device/skypeforbusiness/CsPartnerApplication instances)
{ "operations": [ "move" ], "pagination": { "direction": "asc", "order_by": null, "maximum_limit": 2000, "skip": 0, "current": "/api/device/skypeforbusiness/CsPartnerApplication/?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/skypeforbusiness/CsPartnerApplication/add/?hierarchy=[hierarchy]", "method": "GET", "title": "Add" } }, { "remove": { "support_async": true, "class": "delete", "href": "/api/device/skypeforbusiness/CsPartnerApplication/?hierarchy=[hierarchy]", "method": "DELETE", "title": "Delete" } }, { "bulk_update_form": { "support_async": false, "class": "update", "href": "/api/device/skypeforbusiness/CsPartnerApplication/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/skypeforbusiness/CsPartnerApplication", "method": "POST", "view": "/api/tool/DataMove/?auth_token=[authtoken] } }, { "export": { "title": "Export", "support_async": false, "submit": "payload", "class": "export", "href": "/api/device/skypeforbusiness/CsPartnerApplication/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/skypeforbusiness/CsPartnerApplication/export_bulkload_template/?hierarchy=[hierarchy]", "method": "POST", "title": "Export Bulk Load Template" } }, { "configuration_template": { "support_async": false, "class": "config", "href": "/api/device/skypeforbusiness/CsPartnerApplication/configuration_template/?hierarchy=[hierarchy]", "method": "GET", "title": "Configuration Template" } }, { "field_display_policy": { "support_async": false, "class": "display_policy", "href": "/api/device/skypeforbusiness/CsPartnerApplication/field_display_policy/?hierarchy=[hierarchy]", "method": "GET", "title": "Field Display Policy" } }, { "list": { "support_async": false, "class": "list", "href": "/api/device/skypeforbusiness/CsPartnerApplication/?hierarchy=[hierarchy]", "method": "GET", "title": "List" } }, { "help": { "support_async": false, "class": "help", "href": "/api/device/skypeforbusiness/CsPartnerApplication/help?hierarchy=[hierarchy]", "method": "GET", "title": "Help" } }, { "purge": { "support_async": false, "class": "purge", "href": "/api/device/skypeforbusiness/CsPartnerApplication/purge/?hierarchy=[hierarchy]", "method": "POST", "title": "Purge" } } ], "model_type": "device/skypeforbusiness/CsPartnerApplication", "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/skypeforbusiness/CsPartnerApplication. | GET | /api/device/skypeforbusiness/CsPartnerApplication/help | hierarchy=[hierarchy] | On-line help of Model ref.: device/skypeforbusiness/CsPartnerApplication as HTML |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Modify | PUT | /api/device/skypeforbusiness/CsPartnerApplication/[pkid]/ | hierarchy=[hierarchy] | (For payload specification) |
For Bulk modification, refer to the Bulk Modify section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Delete | DELETE | /api/device/skypeforbusiness/CsPartnerApplication/[pkid]/ | hierarchy=[hierarchy] |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Clone instance with [pkid]. The schema rules are applied. | GET | /api/device/skypeforbusiness/CsPartnerApplication/[pkid]/clone/?schema=&schema_rules=true |
|
A JSON payload with:
|
GET http://[host-proxy]/api/device/skypeforbusiness/CsPartnerApplication/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move | POST | /api/tool/DataMove/[pkid]/?model_type=device/skypeforbusiness/CsPartnerApplication | 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/skypeforbusiness/CsPartnerApplication; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | GET | /api/device/skypeforbusiness/CsPartnerApplication/[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/skypeforbusiness/CsPartnerApplication and the JSON format can be used to import instances of device/skypeforbusiness/CsPartnerApplication.
For Bulk Export, refer to the Bulk Export section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get | GET | /api/device/skypeforbusiness/CsPartnerApplication/[pkid]/ | hierarchy=[hierarchy] | The device/skypeforbusiness/CsPartnerApplication instance with [pkid]. |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Help | GET | /api/device/skypeforbusiness/CsPartnerApplication/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for device/skypeforbusiness/CsPartnerApplication. |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Purge | POST | /api/device/skypeforbusiness/CsPartnerApplication/[pkid]/purge/ | hierarchy=[hierarchy] | If payload required: |