[Index]
Model ref.: device/exchange/SenderFilterConfig
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": { "AdminDisplayName": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "AdminDisplayName", "title": "AdminDisplayName", "required": true, "type": "string" }, "OrganizationId": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "OrganizationId", "title": "OrganizationId", "required": true, "type": "string" }, "WhenCreatedUTC": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenCreatedUTC", "title": "WhenCreatedUTC", "format": "date-time", "required": true, "readonly": false, "type": "string" }, "PSShowComputerName": { "__type_requested": "System.Boolean", "readonly": true, "__type_mapping_type": "Boolean", "name": "PSShowComputerName", "title": "PSShowComputerName", "required": false, "type": "boolean" }, "InternalMailEnabled": { "__type_requested": "System.Boolean", "readonly": false, "__type_mapping_type": "Boolean", "name": "InternalMailEnabled", "title": "InternalMailEnabled", "required": true, "type": "boolean", "description": "The InternalMailEnabled parameter enables or disables sender filtering on authenticated connections from authoritative domains in your organization. Valid input for this parameter is $true or $false. The default value is $false." }, "ObjectClass": { "__type_requested": "Deserialized.Microsoft.Exchange.Data.MultiValuedProperty`1[[System.String,", "__type_mapping_type": "String[]", "name": "ObjectClass", "title": "ObjectClass", "items": { "type": "string" }, "required": true, "readonly": false, "type": "array" }, "PSComputerName": { "__type_requested": "System.String", "readonly": true, "__type_mapping_type": "String", "name": "PSComputerName", "title": "PSComputerName", "required": false, "type": "string" }, "BlockedDomainsAndSubdomains": { "__type_requested": "MultiValuedProperty", "__type_mapping_type": "String[]", "name": "BlockedDomainsAndSubdomains", "title": "BlockedDomainsAndSubdomains", "items": { "type": "string" }, "required": true, "readonly": false, "type": "array", "description": "The BlockedDomainsAndSubdomains parameter specifies the domain names to block. When the Sender Filter agent encounters a message from a domain on this list, or from any of the domain's subdomains, the Sender Filter agent takes the action specified by the Action parameter.\nValid input for this parameter is one or more domains. Wildcard characters aren't permitted. For example, if you specify the value contoso.com, messages from contoso.com, sales.contoso.com, and all other subdomains of contoso.com are blocked by the Sender Filter agent.\nTo enter multiple values and overwrite any existing entries, use the following syntax: <value1>,<value2>.... If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: \"<value1>\",\"<value2>\"....\nTo add or remove one or more values without affecting any existing entries, use the following syntax: @{Add=\"<value1>\",\"<value2>\"...; Remove=\"<value1>\",\"<value2>\"...}.\nThe maximum number of entries for this parameter is 800." }, "Identity": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "Identity", "title": "Identity", "required": true, "type": "string", "description": "This parameter is reserved for internal Microsoft use." }, "DistinguishedName": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "DistinguishedName", "title": "DistinguishedName", "required": true, "type": "string" }, "RecipientBlockedSenderAction": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "RecipientBlockedSenderAction", "title": "RecipientBlockedSenderAction", "required": true, "type": "string", "description": "The RecipientBlockedSenderAction parameter specifies the action that the Sender Filter agent takes on messages received from blocked senders that are defined by SafeList aggregation. SafeList aggregation adds blocked senders that are defined by your users in Microsoft Outlook or Outlook Web App to the Blocked Senders list that's used by the Sender Filter agent.\nValid input for this parameter is Delete or Reject. The default value is Reject." }, "OriginatingServer": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "OriginatingServer", "title": "OriginatingServer", "required": true, "type": "string" }, "Name": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "Name", "title": "Name", "required": true, "type": "string" }, "BlockedDomains": { "__type_requested": "MultiValuedProperty", "__type_mapping_type": "String[]", "name": "BlockedDomains", "title": "BlockedDomains", "items": { "type": "string" }, "required": true, "readonly": false, "type": "array", "description": "The BlockedDomains parameter specifies the domain names to block. When the Sender Filter agent encounters a message from a domain on this list, the Sender Filter agent takes the action specified by the Action parameter.\nValid input for this parameter is one or more domains or subdomains. Wildcard characters aren't permitted. For example, if you specify the values contoso.com and marketing.contoso.com, only messages from those domains are blocked by the Sender Filter agent. Messages from sales.contoso.com aren't blocked by the Sender Filter agent.\nTo enter multiple values and overwrite any existing entries, use the following syntax: <value1>,<value2>.... If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: \"<value1>\",\"<value2>\"....\nTo add or remove one or more values without affecting any existing entries, use the following syntax: @{Add=\"<value1>\",\"<value2>\"...; Remove=\"<value1>\",\"<value2>\"...}.\nThe maximum number of entries for this parameter is 800." }, "Enabled": { "__type_requested": "System.Boolean", "readonly": false, "__type_mapping_type": "Boolean", "name": "Enabled", "title": "Enabled", "required": true, "type": "boolean", "description": "The Enabled parameter enables or disables sender filtering on your Exchange server. Valid input for this parameter is $true or $false. The default value is $true." }, "BlankSenderBlockingEnabled": { "__type_requested": "System.Boolean", "readonly": false, "__type_mapping_type": "Boolean", "name": "BlankSenderBlockingEnabled", "title": "BlankSenderBlockingEnabled", "required": true, "type": "boolean", "description": "The BlankSenderBlockingEnabled parameter blocks or allows messages that don't contain a sender value in the SMTP command MAIL FROM. Valid input for this parameter is $true or $false. The default value is $false." }, "ExternalMailEnabled": { "__type_requested": "System.Boolean", "readonly": false, "__type_mapping_type": "Boolean", "name": "ExternalMailEnabled", "title": "ExternalMailEnabled", "required": true, "type": "boolean", "description": "The ExternalMailEnabled parameter enables or disables sender filtering on unauthenticated connections from external messaging servers. Valid input for this parameter is $true or $false. The default value is $true." }, "WhenCreated": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenCreated", "title": "WhenCreated", "format": "date-time", "required": true, "readonly": false, "type": "string" }, "Action": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "Action", "title": "Action", "required": true, "type": "string", "description": "The Action parameter specifies the action that the Sender Filter agent takes on messages from blocked senders or domains. Valid input for this parameter is StampStatus or Reject. The default value is Reject." }, "ExchangeVersion": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "ExchangeVersion", "title": "ExchangeVersion", "required": true, "type": "string" }, "BlockedSenders": { "__type_requested": "MultiValuedProperty", "__type_mapping_type": "String[]", "name": "BlockedSenders", "title": "BlockedSenders", "items": { "type": "string" }, "required": true, "readonly": false, "type": "array", "description": "The BlockedSenders parameter specifies one or more SMTP email addresses to block. When the Sender Filter agent encounters a message from a sender on this list, the Sender Filter agent takes the action specified by the Action parameter.\nTo enter multiple values and overwrite any existing entries, use the following syntax: <value1>,<value2>.... If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: \"<value1>\",\"<value2>\"....\nTo add or remove one or more values without affecting any existing entries, use the following syntax: @{Add=\"<value1>\",\"<value2>\"...; Remove=\"<value1>\",\"<value2>\"...}.\nThe maximum number of entries for this parameter is 800." }, "ObjectCategory": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "ObjectCategory", "title": "ObjectCategory", "required": true, "type": "string" }, "IsValid": { "__type_requested": "System.Boolean", "readonly": false, "__type_mapping_type": "Boolean", "name": "IsValid", "title": "IsValid", "required": true, "type": "boolean" }, "WhenChanged": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenChanged", "title": "WhenChanged", "format": "date-time", "required": true, "readonly": false, "type": "string" }, "WhenChangedUTC": { "__type_requested": "System.DateTime", "__type_mapping_type": "DateTime", "name": "WhenChangedUTC", "title": "WhenChangedUTC", "format": "date-time", "required": true, "readonly": false, "type": "string" }, "ObjectState": { "__type_requested": "System.String", "readonly": false, "__type_mapping_type": "String", "name": "ObjectState", "title": "ObjectState", "required": true, "type": "string" }, "RunspaceId": { "__type_requested": "System.Guid", "readonly": true, "__type_mapping_type": "String", "name": "RunspaceId", "title": "RunspaceId", "required": false, "type": "string" }, "Guid": { "__type_requested": "System.Guid", "readonly": false, "__type_mapping_type": "String", "name": "Guid", "title": "Guid", "required": true, "type": "string" } }, "schema_version": "15312" }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Bulk Modify | GET | /api/device/exchange/SenderFilterConfig/bulk_update/?schema=&schema_rules=true |
|
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk Modify | POST | /api/device/exchange/SenderFilterConfig/bulk_update/ |
|
For example: {"data":{"name":"value"}, "meta":{}, "request_meta":{ "hrefs":["/api/v0/device/exchange/SenderFilterConfig/[pkid1]", "/api/v0/device/exchange/SenderFilterConfig/[pkid2]",...]}} |
GET http://[host-proxy]/api/device/exchange/SenderFilterConfig/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move the instance with [pkid] to [target_hierarchy] | POST | /api/tool/DataMove/?model_type=device/exchange/SenderFilterConfig |
|
{"hrefs": ["/api/device/exchange/SenderFilterConfig/[pkid]"]} |
Bulk Move | POST | /api/tool/DataMove/?model_type=device/exchange/SenderFilterConfig |
|
{"hrefs": ["/api/device/exchange/SenderFilterConfig/[pkid1]", "/api/device/exchange/SenderFilterConfig/[pkid2]",...]} |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Get a selected [export_format] of the schema and instances [pkid1], [pkid2],... of device/exchange/SenderFilterConfig; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | POST | /api/device/exchange/SenderFilterConfig/export/ |
|
{ "hrefs":["/api/device/exchange/SenderFilterConfig/[pkid1]", "/api/device/exchange/SenderFilterConfig/[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/exchange/SenderFilterConfig and the JSON format can be used to import instances of device/exchange/SenderFilterConfig.
GET http://[host-proxy]/api/device/exchange/SenderFilterConfig/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a compressed format of the Bulk Load spreadsheet template for device/exchange/SenderFilterConfig | POST | /api/device/exchange/SenderFilterConfig/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/exchange/SenderFilterConfig/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Field Display Policy | GET | /api/device/exchange/SenderFilterConfig/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
List | GET | /api/device/exchange/SenderFilterConfig/ |
|
The device/exchange/SenderFilterConfig schema and all instances as JSON. |
(The list will return 0 to 3 device/exchange/SenderFilterConfig instances)
{ "pagination": { "skip": 0, "limit": 3, "maximum_limit": 2000, "total": 0, "total_limit": null, "order_by": "Name", "direction": "asc", "current": "/api/device/exchange/SenderFilterConfig/?skip=0&limit=3&order_by=Name&direction=asc&traversal=down" }, "operations": [ "move" ], "meta": { "model_type": "device/exchange/SenderFilterConfig", "summary_attrs": [ { "name": "Name", "title": "Name" }, { "name": "hierarchy_friendly_name", "title": "Located At", "allow_filtering": true } ], "tagged_versions": [], "tags": [], "title": "", "business_key": {}, "api_version": "21.2", "cached": true, "references": { "children": [], "parent": [ { "href": "/api/data/HierarchyNode/6t0ggef2c0deab00hb595101", "pkid": "6t0ggef2c0deab00hb595101" } ], "device": [ { "href": "", "pkid": "" } ], "foreign_key": [] }, "model_specific_actions": [ "get", "list", "update", "bulk_update_form", "clone", "configuration_template", "export", "export_bulkload_template", "field_display_policy", "help", "move" ], "schema_version": "15312", "actions": [ { "bulk_update_form": { "method": "GET", "class": "update", "href": "/api/device/exchange/SenderFilterConfig/bulk_update/?hierarchy=[hierarchy]&schema=&schema_rules=true", "support_async": false, "title": "Bulk Modify" } }, { "move": { "method": "POST", "class": "move", "href": "/api/tool/DataMove/?hierarchy=[hierarchy]&model_type=device/exchange/SenderFilterConfig", "support_async": true, "title": "Move", "view": "/api/tool/DataMove/?auth_token=[authtoken] } }, { "export": { "method": "POST", "class": "export", "href": "/api/device/exchange/SenderFilterConfig/export/?hierarchy=[hierarchy]", "support_async": false, "title": "Export", "view": "/api/view/ExportData/add/?auth_token=[authtoken], "submit": "payload" } }, { "export_bulkload_template": { "method": "POST", "class": "bulkload_template", "href": "/api/device/exchange/SenderFilterConfig/export_bulkload_template/?hierarchy=[hierarchy]", "support_async": false, "title": "Export Bulk Load Template" } }, { "configuration_template": { "method": "GET", "class": "config", "href": "/api/device/exchange/SenderFilterConfig/configuration_template/?hierarchy=[hierarchy]", "support_async": false, "title": "Configuration Template" } }, { "field_display_policy": { "method": "GET", "class": "display_policy", "href": "/api/device/exchange/SenderFilterConfig/field_display_policy/?hierarchy=[hierarchy]", "support_async": false, "title": "Field Display Policy" } }, { "list": { "method": "GET", "class": "list", "href": "/api/device/exchange/SenderFilterConfig/?hierarchy=[hierarchy]", "support_async": false, "title": "List" } }, { "help": { "method": "GET", "class": "help", "href": "/api/device/exchange/SenderFilterConfig/help?hierarchy=[hierarchy]", "support_async": false, "title": "Help" } }, { "purge": { "method": "POST", "class": "purge", "href": "/api/device/exchange/SenderFilterConfig/purge/?hierarchy=[hierarchy]", "support_async": false, "title": "Purge" } } ] }, "resources": [] }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the on-line Help for device/exchange/SenderFilterConfig. | GET | /api/device/exchange/SenderFilterConfig/help | hierarchy=[hierarchy] | On-line help of Model ref.: device/exchange/SenderFilterConfig as HTML |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Purge | POST | /api/device/exchange/SenderFilterConfig/purge/ |
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Modify | PUT | /api/device/exchange/SenderFilterConfig/[pkid] | hierarchy=[hierarchy] | (For payload specification) |
For Bulk modification, refer to the Bulk Modify section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Clone instance with [pkid]. The schema rules are applied. | GET | /api/device/exchange/SenderFilterConfig/[pkid]/clone/?schema=&schema_rules=true |
|
A JSON payload with:
|
GET http://[host-proxy]/api/device/exchange/SenderFilterConfig/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move | POST | /api/tool/DataMove/[pkid]/?model_type=device/exchange/SenderFilterConfig | 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/exchange/SenderFilterConfig; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | GET | /api/device/exchange/SenderFilterConfig/[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/exchange/SenderFilterConfig and the JSON format can be used to import instances of device/exchange/SenderFilterConfig.
For Bulk Export, refer to the Bulk Export section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get | GET | /api/device/exchange/SenderFilterConfig/[pkid] | hierarchy=[hierarchy] | The device/exchange/SenderFilterConfig instance with [pkid]. |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Help | GET | /api/device/exchange/SenderFilterConfig/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for device/exchange/SenderFilterConfig. |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Purge | POST | /api/device/exchange/SenderFilterConfig/[pkid]/purge | hierarchy=[hierarchy] | If payload required: |