Search Device Management Policy

Searches for a device management policy with a policy name.

Path Parameters

  • clientIdstringrequired

    Describes the clientId or partnerId of the tenant

Query Parameters

  • namestring

    Device management policy name.

Responses

  • matchTypestring

    (Optional) The type of match: -To match all the filter conditions, provide matchType: ALL. - To match any one of the filter conditions, provide matchType: ANY.

    Enum:
    ALLANY
  • rulesarray

    (Optional) Filter devices with specific attributes: - Attribute name of device. Example: Name, Operating System. Attribute names change with device types. - Matching parameter. Supported operators are: Equals, Contains, Not Contains, Starts with, Ends with, Regex. Learn more about Regex. - Type of resource

  • actionsarray

    - Supported actions - ASSIGN MONITORINGTEMPLATE - ASSIGN KNOWLEDGEARTICLE - Assign Availability Rule - ASSIGN CUSTOMATTRIBUTES - Assign Jobs - ASSIGN CREDENTIALSET - Supported values for items for given action - For Assign Availability Rule , item value is AND - For ASSIGN CUSTOMATTRIBUTES, item value is tagName[value='tagValue'] - For all others this is number in string eg "12345" - Scenarios for Custom attributes item values in response payload - New TagName : New Tag created with given Name and Tag Value, and Assigned. - Id of New Tag Value added to response - Old TagName and New Tag Value : New Tag Value added to Tag and Assigned - Id of New Tag Value added to response. - Old TagName and Old TagValue : Both the details are verfied and Assigned - Id of TagValue added to Response

  • idinteger

  • namestring

    Name of the policy.

  • resourceTypestring

    Type of resource. Example: DEVICE, VOLUME, VPN, XENSERVER

  • executionOrderinteger

  • clientMatchingTypestring

    - The clientMatchingType field is optional and when not passed defaults to the following "clientMatchingType": "ALL" - The clientMatchingType field is applicable at partner-level DMP only. - If clientMatchingType EXCLUDE/INCLUDE, then the clients field is mandatory. - On policy update, if clientMatchingType is not passed then clientMatchingType will be updated to ALL and client selection will be removed.

    Enum:
    EXCLUDEINCLUDEALL

    Default: ALL

  • clientsarray

  • searchQuerystring

    Search query string for filtering resources.

  • parentPolicyinteger

    ID of the parent policy from which this policy is being cloned. This numerical field can be given as part of payload to create a child policy.

  • uidstring

    Unique identifier string for the policy.

  • createdDatestring

    Policy created date.

  • updatedDatestring

    Policy last updated date.

  • systemQuerystring

    System-generated query string for additional filtering criteria. System-generated query string containing the parent policy query. User-defined search query will append to this system query with AND condition as present in UI.

  • completeSearchQuerystring

    Combined search query including both user-defined and system-generated criteria.

  • parentPolicyUIDstring

    Unique identifier string of the parent policy

  • customizedboolean

    Indicates whether the policy has been customized from its parent.

  • globalPolicyboolean

    Indicates whether this is a global policy or tenant-specific.

Loading Examples...