Merge main and v2025 branch

This commit is contained in:
Tyler Mairose
2025-03-31 16:06:59 -04:00
5323 changed files with 505932 additions and 142543 deletions

View File

@@ -38,6 +38,7 @@ jobs:
role-to-assume: arn:aws:iam::176038645705:role/github-action-role role-to-assume: arn:aws:iam::176038645705:role/github-action-role
role-session-name: deploy-developer-site-infra-to-aws role-session-name: deploy-developer-site-infra-to-aws
aws-region: us-east-1 aws-region: us-east-1
role-duration-seconds: 7200
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
- name: Check out repo - name: Check out repo
@@ -83,7 +84,6 @@ jobs:
export NODE_OPTIONS="--max_old_space_size=16384" export NODE_OPTIONS="--max_old_space_size=16384"
export DOCUSAURUS_IGNORE_SSG_WARNINGS=true export DOCUSAURUS_IGNORE_SSG_WARNINGS=true
npm ci npm ci
npm run gen-all-api-specs-code-examples
npm run gen-api-docs-all npm run gen-api-docs-all
npm run build npm run build
# push these files to AWS # push these files to AWS

7
.gitignore vendored
View File

@@ -30,6 +30,13 @@ yarn.lock
/products/iiq/api /products/iiq/api
/products/nerm/api /products/nerm/api
/static/code-examples/beta/beta.yaml
/static/code-examples/beta/merged_code_examples.yaml
/static/code-examples/v3/v3.yaml
/static/code-examples/v3/merged_code_examples.yaml
/static/code-examples/v2024/v2024.yaml
/static/code-examples/v2024/merged_code_examples.yaml
/docs/api/v3/* /docs/api/v3/*
/docs/api/beta/* /docs/api/beta/*
/docs/api/iiq /docs/api/iiq

View File

@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
| API | Postman Collection | | API | Postman Collection |
| --- | --- | | --- | --- |
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> | | V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> | | V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> | | Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |

View File

@@ -20,6 +20,7 @@ Each ISC API version is broken out into a separate collection within the workspa
| API | Postman Collection | | API | Postman Collection |
| --- | --- | | --- | --- |
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> | | V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> | | V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> | | Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |

View File

@@ -19,3 +19,9 @@ There is a rate limit of 100 requests per `access_token` per 10 seconds for V3 A
**Headers**: **Headers**:
- **Retry-After**: [seconds to wait before rate limit resets] - **Retry-After**: [seconds to wait before rate limit resets]
:::info
Specific APIs may have different rate limiting. Refer to their specifications for this information.
:::

View File

@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
| API | Postman Collection | | API | Postman Collection |
| --- | --- | | --- | --- |
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> | | V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> | | V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> | | Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |

View File

@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
| API | Postman Collection | | API | Postman Collection |
| --- | --- | | --- | --- |
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> | | V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> | | V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> | | Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |

View File

@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
| API | Postman Collection | | API | Postman Collection |
| --- | --- | | --- | --- |
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> | | V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> | | V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> | | Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |

View File

@@ -136,8 +136,7 @@ You cannot import Non-Employee sources.
**Description** **Description**
[This endpoint](https://developer.sailpoint.com/docs/api/beta/list-sp-config-objects) gets the list of object configurations known to the tenant export/import service. [This endpoint](https://developer.sailpoint.com/docs/api/beta/list-sp-config-objects) gets the list of object configurations the tenant export/import service knows.
Object configurations containing "importUrl" and "exportUrl" are available for export/import.
<Tabs> <Tabs>
<TabItem value="request" label="Request" default> <TabItem value="request" label="Request" default>

View File

@@ -33,7 +33,7 @@ This is an example input from this trigger:
## Prerequisites ## Prerequisites
Before consuming this event trigger, the following prerequesites must be met: Before consuming this event trigger, the following prerequisites must be met:
- Your organization must have Access Insights to access Identity Outliers. - Your organization must have Access Insights to access Identity Outliers.
- Your organization must have configured a source and loaded account data. - Your organization must have configured a source and loaded account data.

View File

@@ -10,12 +10,6 @@ slug: /extensibility/event-triggers/triggers/identity-deleted
tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget'] tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget']
--- ---
:::info
This is an early access event trigger. Please contact support to have it enabled in your tenant.
:::
## Event Context ## Event Context
![Flow](./img/identity-deleted-path.png) ![Flow](./img/identity-deleted-path.png)

View File

@@ -10,14 +10,14 @@ slug: /extensibility/event-triggers/triggers/source-account-created
tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget'] tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget']
--- ---
:::info ## Event Context
This is an early access event trigger. Please contact support to have it enabled in your tenant. :::warning
This event trigger has been deprecated, and support will no longer handle requests to enable this trigger. A newer version of this trigger is being developed, and this documentation will be updated once the new trigger is available.
::: :::
## Event Context
Source Account Created events occur after a new account is detected during an account aggregration and refresh from a source. This trigger cannot determine whether account creation happened on a source or in Identity Security Cloud. It omits events related to Identity Security Cloud accounts, such as the Identity Security Cloud Admin. Source Account Created events occur after a new account is detected during an account aggregration and refresh from a source. This trigger cannot determine whether account creation happened on a source or in Identity Security Cloud. It omits events related to Identity Security Cloud accounts, such as the Identity Security Cloud Admin.
Use this event trigger to watch for new accounts with highly privileged access, such as an account created in Active Directory Domain Admins. Use this event trigger to watch for new accounts with highly privileged access, such as an account created in Active Directory Domain Admins.

View File

@@ -10,14 +10,14 @@ slug: /extensibility/event-triggers/triggers/source-account-deleted
tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget'] tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget']
--- ---
:::info ## Event Context
This is an early access event trigger. Please contact support to have it enabled in your tenant. :::warning
This event trigger has been deprecated, and support will no longer handle requests to enable this trigger. A newer version of this trigger is being developed, and this documentation will be updated once the new trigger is available.
::: :::
## Event Context
Source Account Deleted events occur whenever an account is deleted from its source during an account aggregation operation. The account may have been manually removed or deleted as the result of a provisioning event. The trigger cannot determine whether the account deletion happened on a source or in Identity Security Cloud. It omits events related to Identity Security Cloud accounts, such as the Identity Security Cloud Admin. Source Account Deleted events occur whenever an account is deleted from its source during an account aggregation operation. The account may have been manually removed or deleted as the result of a provisioning event. The trigger cannot determine whether the account deletion happened on a source or in Identity Security Cloud. It omits events related to Identity Security Cloud accounts, such as the Identity Security Cloud Admin.
Use this event trigger to watch for deletions of authoritative accounts, such as an account deleted on Workday. Use this event trigger to watch for deletions of authoritative accounts, such as an account deleted on Workday.

View File

@@ -10,14 +10,14 @@ slug: /extensibility/event-triggers/triggers/source-account-updated
tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget'] tags: ['Event Triggers', 'Early Access Event Triggers', 'Fire and Forget']
--- ---
:::info ## Event Context
This is an early access event trigger. Please contact support to have it enabled in your tenant. :::warning
This event trigger has been deprecated, and support will no longer handle requests to enable this trigger. A newer version of this trigger is being developed, and this documentation will be updated once the new trigger is available.
::: :::
## Event Context
Source Account Updated events occur whenever one or more account attributes change on a single account during an account aggregation operation. The trigger cannot determine whether the account update happened on a source or in Identity Security Cloud. It omits events related to Identity Security Cloud accounts, such as the Identity Security Cloud Admin. The following actions are considered updates: Source Account Updated events occur whenever one or more account attributes change on a single account during an account aggregation operation. The trigger cannot determine whether the account update happened on a source or in Identity Security Cloud. It omits events related to Identity Security Cloud accounts, such as the Identity Security Cloud Admin. The following actions are considered updates:
- Update account attributes - Update account attributes

View File

@@ -1,19 +1,19 @@
--- ---
id: rule-utility id: rule-utility
title: Using ISCRuleUtil as a Wrapper for Common Rule Operations title: Using IdnRuleUtil as a Wrapper for Common Rule Operations
pagination_label: Identity Security Cloud Rule Utility pagination_label: Identity Security Cloud Rule Utility
sidebar_label: Identity Security Cloud Rule Utility sidebar_label: Identity Security Cloud Rule Utility
sidebar_position: 4 sidebar_position: 4
sidebar_class_name: ruleUtility sidebar_class_name: ruleUtility
keywords: ['rule', 'utility'] keywords: ['rule', 'utility']
description: Using ISCRuleUtil as a Wrapper for Common Rule Operations description: Using IdnRuleUtil as a Wrapper for Common Rule Operations
slug: /extensibility/rules/rule-utility slug: /extensibility/rules/rule-utility
tags: ['Rules'] tags: ['Rules']
--- ---
## Overview ## Overview
Use this guide to learn how to configure searchable account attributes within Identity Security Cloud and then leverage them within the ISCRuleUtil wrapper class when searching accounts for attributes such as uniqueness checks. There are also methods in the ISCRuleUtil wrapper class you can use without the additional searchable attributes. Use this guide to learn how to configure searchable account attributes within Identity Security Cloud and then leverage them within the IdnRuleUtil wrapper class when searching accounts for attributes such as uniqueness checks. There are also methods in the IdnRuleUtil wrapper class you can use without the additional searchable attributes.
Search attributes allow you to search across accounts and sources to determine whether a specific attribute value is being used in your Identity Security Cloud environment. Search attributes allow you to search across accounts and sources to determine whether a specific attribute value is being used in your Identity Security Cloud environment.

View File

@@ -67,9 +67,9 @@ You must use a `firstValid`. If the identity does not have a manager, `getManage
} }
``` ```
### Get manager status of the identity ### Get managerial status of the identity
This example would get the status of whether or not the identity is currently actually a manager. This example would get a boolean response indicating whether the identity is listed as the manager of another identity.
```json ```json
{ {

View File

@@ -0,0 +1,90 @@
---
id: aic-ciem-er-diagram
title: Access Intelligence Center CIEM ER Diagram
pagination_label: Access Intelligence Center CIEM ER Diagram
sidebar_label: CIEM Entity Relationship Diagram
sidebar_position: 3
sidebar_class_name: AccessIntelligenceCenter
keywords: ['data listing', 'data share', 'secure data sharing']
description: Access Intelligence Center CIEM ER Diagram
slug: /reporting/aic-ciem-er-diagram
tags: ['AccessIntelligenceCenter', 'AIC', 'CIEM']
hide_table_of_contents: true
---
import MermaidViewer from '@site/src/components/MermaidViewer';
# Access Intelligence Center CIEM ER Diagram
<!-- Identity Attributes are to be worked on later because there are no current default values -->
<MermaidViewer diagram='erDiagram
"Entitlement Service Usage" {
varchar ENTITLEMENT_VALUE PK "ISC entitlement value associated with the access. Usually the cloud native ID."
varchar CIEM_KEY PK "composite key: CLOUD_PROVIDER-SERVICE-ENTITLEMENT_ACCOUNT_NATIVE_IDENTITY-CLOUD_SOURCE_NATIVE_ID"
varchar ACCESS_ASSIGNMENT_ID "Cloud native ID of the access assignment object. AWS: <policy arn>|<statement id> GCP: <policy id>:<role id>, Azure: RoleAssignment, RoleAssignmentScheduleInstance (PIM) or RoleEligibilityScheduleInstance (PIM)"
varchar ACCOUNT_CLOUD_NAME "Cloud provider associated with the account (AWS|GCP|Okta|Azure). When the access is federated, this will be different than CLOUD_PROVIDER."
varchar DISPLAY_NAME "Account display name"
varchar ACCOUNT_EMAIL "Account email. Note: AWS IAM users will not have email"
varchar ENTITLEMENT_ACCOUNT_NATIVE_ID "Account native id"
varchar CLOUD_PROVIDER "Cloud provider of the service the account has access to (aws|gcp|azure)"
varchar CLOUD_SOURCE_DISPLAY_NAME "Cloud native display name of the service source. AWS: Management account, Azure: Tenant, GCP: Org"
varchar CLOUD_SOURCE_NATIVE_ID "Cloud native ID of the services source"
varchar CLOUD_SUB_SOURCE_DISPLAY_NAME "Cloud native display name of the service sub-source (if applicable). AWS: Managed account, Azure: Subscription, GCP: Project"
varchar CLOUD_SUB_SOURCE_NATIVE_ID "Cloud native ID of the services sub-source (if applicable)"
varchar SERVICE "Cloud service for which usage is being determined"
varchar SOURCE_NAME "ISC source name associated with the cloud service"
array ENTITLEMENT_USAGE "Aggregated usage across all accounts and services for the ENTITLEMENT_VALUE"
}
"Resource Access" {
varchar CIEM_KEY PK "composite key: CLOUD_PROVIDER-SERVICE-ENTITLEMENT_ACCOUNT_NATIVE_IDENTITY-CLOUD_SOURCE_NATIVE_ID"
varchar ACCOUNT_NATIVE_IDENTITY "Account native ID"
varchar ACCESS_LEVEL "The access level(s) the account has to the resource (Read, Write, Admin)"
varchar ACCOUNT_SOURCE_TYPE "Cloud provider of the account GCP|AWS|Azure|Okta"
varchar RESOURCE_ACCESS_CLOUD_PROVIDER "Cloud provider of the resource (GCP|AWS|Azure)"
varchar RESOURCE_ACCESS_CLOUD_SOURCE_NATIVE_ID "Cloud sub-source native ID of the resources source (if applicable)"
varchar RESOURCE_ACCESS_CLOUD_SOURCE_SUB_NATIVE_ID "Cloud provider of the service the account has access to (GCP|AWS|Azure)"
varchar RESOURCE_ACCOUNT_NAME "Cloud native display name of the resource source. AWS: Account name, Azure: Subscription name, GCP: Project name"
varchar RESOURCE_ID "Cloud native ID of the resource"
varchar RESOURCE_NAME "Human readable name of the resource (if available)"
varchar RESOURCE_TYPE "Resource type, derived from the cloud API response types"
varchar RESOURCE_ACCESS_SERVICE "Cloud service associated with the resource"
varchar RESOURCE_ACCESS_SOURCE_NAME "ISC source name associated with the resource"
}
ENTITLEMENT {
varchar ENTITLEMENT_VALUE PK "ISC entitlement value associated with the access. Usually the cloud native ID."
varchar ENTITLEMENT_ATTRIBUTE "Entitlement type as determined by ISC sources"
varchar ENTITLEMENT_DISPLAY_NAME "Human readable name of the entitlement as constructed by ISC"
timestamp ENTITLEMENT_SYNC_DATE "Timestamp of latest sync of entitlement to source tables"
}
IDENTITY {
varchar IDENTITY_ID PK "Unique identifier of the identity"
varchar TENANT_ID PK "Tenant unique identifier"
timestamp IDENTITY_CREATED "Identity created date in ISC"
timestamp IDENTITY_UPDATED "Identity modified date in ISC"
varchar NAME "Name of the identity"
varchar IDENTITY_DISPLAY_NAME "User friendly label for the identity. Usually First Name Last Name."
varchar IDENTITY_MANAGERS_NAME "Name of the manager of the identity"
varchar EMAIL "Email of the identity"
varchar STATUS "Status of the identity"
varchar JOB_TITLE "Job title of the identity"
varchar LOCATION "Location of the identity"
varchar LOCATION_CODE "Location code of the identity"
varchar DEPARTMENT "Department of the identity"
timestamp IDENTITY_SYNC_DATE "Timestamp of latest sync of identity to source tables"
}
ACCOUNT {
varchar ACCOUNT_NATIVE_IDENTITY PK "Cloud native ID of account"
varchar IDENTITY_ID PK "ISC unique identifier of the identity correlated with the account (null if uncorrelated)"
varchar ACCOUNT_ID "ISC unique identifier of account"
varchar ACCOUNT_NAME "Name of account as configured in ISC"
varchar ACCOUNT_CREATED_DATE "Account creation date (ingestion/creation in ISC)"
varchar ACCOUNT_UPDATED_DATE "Account update date (updated in ISC)"
varchar ACCOUNT_DISPLAY_NAME "Display name of account as configured in ISC"
varchar ACCOUNT_STATUS "Status of account (Enabled|Disabled|Locked)"
varchar ACCOUNT_SYNC_DATE "Timestamp of latest sync of record to source tables"
}
IDENTITY ||--o{ ACCOUNT : "associated to"
ACCOUNT ||--o{ "Resource Access" : "associated to"
"Resource Access" }o--o{ "Entitlement Service Usage": "associated to"
"Entitlement Service Usage" }o--|| ENTITLEMENT : "associated to"'></MermaidViewer>

View File

@@ -3,7 +3,7 @@ id: access-intelligence-center-videos
title: Access Intelligence Center Videos title: Access Intelligence Center Videos
pagination_label: Access Intelligence Center Videos pagination_label: Access Intelligence Center Videos
sidebar_label: Videos sidebar_label: Videos
sidebar_position: 2 sidebar_position: 3
sidebar_class_name: AccessIntelligenceCenter sidebar_class_name: AccessIntelligenceCenter
keywords: ['data listing', 'data share', 'secure data sharing'] keywords: ['data listing', 'data share', 'secure data sharing']
description: Access Intelligence Center Videos description: Access Intelligence Center Videos

View File

@@ -23,7 +23,7 @@ When users only need Active Directory employee access, they can request access t
When users need both Active Directory employee and developer access, they can request access to the &#39;AD Developers&#39; access profile. When users need both Active Directory employee and developer access, they can request access to the &#39;AD Developers&#39; access profile.
Access profiles are the most important units of access in Identity Security Cloud. Identity Security Cloud uses access profiles in many features, including the following: Identity Security Cloud uses access profiles in many features, including the following:
- Provisioning: When you use the Provisioning Service, lifecycle states and roles both grant access to users in the form of access profiles. - Provisioning: When you use the Provisioning Service, lifecycle states and roles both grant access to users in the form of access profiles.
@@ -62,9 +62,9 @@ Method | HTTP request | Description
## create-access-profile ## create-access-profile
Use this API to create an access profile. Create an access profile.
A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API. In addition, a token with only ROLE_SUBADMIN or SOURCE_SUBADMIN authority must be associated with the access profile's Source. A user with only ROLE_SUBADMIN or SOURCE_SUBADMIN authority must be associated with the access profile's Source.
The maximum supported length for the description field is 2000 characters. Longer descriptions will be preserved for existing access profiles, however, any new access profiles as well as any updates to existing descriptions will be limited to 2000 characters. The maximum supported length for the description field is 2000 characters. Longer descriptions will be preserved for existing access profiles. However, any new access profiles as well as any updates to existing descriptions are limited to 2000 characters.
[API Spec](https://developer.sailpoint.com/docs/api/beta/create-access-profile) [API Spec](https://developer.sailpoint.com/docs/api/beta/create-access-profile)
@@ -397,22 +397,22 @@ try {
[[Back to top]](#) [[Back to top]](#)
## list-access-profiles ## list-access-profiles
Use this API to get a list of access profiles. Get a list of access profiles.
A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API. >**Note:** When you filter for access profiles that have the '+' symbol in their names, the response is blank.
[API Spec](https://developer.sailpoint.com/docs/api/beta/list-access-profiles) [API Spec](https://developer.sailpoint.com/docs/api/beta/list-access-profiles)
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Query | ForSubadmin | **String** | (optional) | If provided, filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID, or the special value **me**, which is shorthand for the calling identity's ID. A 400 Bad Request error is returned if the **for-subadmin** parameter is specified for an identity that is not a subadmin. Query | ForSubadmin | **String** | (optional) | Filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID or the special value **me**, which is shorthand for the calling identity's ID. If you specify an identity that isn't a subadmin, the API returns a 400 Bad Request error.
Query | Limit | **Int32** | (optional) (default to 50) | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names. Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names.
Query | Sorters | **String** | (optional) | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified** Query | Sorters | **String** | (optional) | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified**
Query | ForSegmentIds | **String** | (optional) | If present and not empty, additionally filters access profiles to those which are assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error. Query | ForSegmentIds | **String** | (optional) | Filters access profiles to only those assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error.
Query | IncludeUnsegmented | **Boolean** | (optional) (default to $true) | Indicates whether the response list should contain unsegmented access profiles. If *for-segment-ids* is absent or empty, specifying *include-unsegmented* as false results in an error. Query | IncludeUnsegmented | **Boolean** | (optional) (default to $true) | Indicates whether the response list should contain unsegmented access profiles. If `for-segment-ids` is absent or empty, specifying *include-unsegmented* as `false` results in an error.
### Return type ### Return type
[**AccessProfile[]**](../models/access-profile) [**AccessProfile[]**](../models/access-profile)
@@ -433,14 +433,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$ForSubadmin = "8c190e6787aa4ed9a90bd9d5344523fb" # String | If provided, filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID, or the special value **me**, which is shorthand for the calling identity's ID. A 400 Bad Request error is returned if the **for-subadmin** parameter is specified for an identity that is not a subadmin. (optional) $ForSubadmin = "8c190e6787aa4ed9a90bd9d5344523fb" # String | Filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID or the special value **me**, which is shorthand for the calling identity's ID. If you specify an identity that isn't a subadmin, the API returns a 400 Bad Request error. (optional)
$Limit = 50 # Int32 | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 50) $Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
$Filters = 'name eq "SailPoint Support"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names. (optional) $Filters = 'name eq "SailPoint Support"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names. (optional)
$Sorters = "name,-modified" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified** (optional) $Sorters = "name,-modified" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified** (optional)
$ForSegmentIds = "0b5c9f25-83c6-4762-9073-e38f7bb2ae26,2e8d8180-24bc-4d21-91c6-7affdb473b0d" # String | If present and not empty, additionally filters access profiles to those which are assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error. (optional) $ForSegmentIds = "0b5c9f25-83c6-4762-9073-e38f7bb2ae26,2e8d8180-24bc-4d21-91c6-7affdb473b0d" # String | Filters access profiles to only those assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error. (optional)
$IncludeUnsegmented = $false # Boolean | Indicates whether the response list should contain unsegmented access profiles. If *for-segment-ids* is absent or empty, specifying *include-unsegmented* as false results in an error. (optional) (default to $true) $IncludeUnsegmented = $false # Boolean | Indicates whether the response list should contain unsegmented access profiles. If `for-segment-ids` is absent or empty, specifying *include-unsegmented* as `false` results in an error. (optional) (default to $true)
# List Access Profiles # List Access Profiles

View File

@@ -17,14 +17,14 @@ All URIs are relative to *https://sailpoint.api.identitynow.com/beta*
Method | HTTP request | Description Method | HTTP request | Description
------------- | ------------- | ------------- ------------- | ------------- | -------------
[**Add-BetaAccessRequestRecommendationsIgnoredItem**](#add-access-request-recommendations-ignored-item) | **POST** `/ai-access-request-recommendations/ignored-items` | Notification of Ignored Access Request Recommendations [**Add-BetaAccessRequestRecommendationsIgnoredItem**](#add-access-request-recommendations-ignored-item) | **POST** `/ai-access-request-recommendations/ignored-items` | Ignore Access Request Recommendation
[**Add-BetaAccessRequestRecommendationsRequestedItem**](#add-access-request-recommendations-requested-item) | **POST** `/ai-access-request-recommendations/requested-items` | Notification of Requested Access Request Recommendations [**Add-BetaAccessRequestRecommendationsRequestedItem**](#add-access-request-recommendations-requested-item) | **POST** `/ai-access-request-recommendations/requested-items` | Accept Access Request Recommendation
[**Add-BetaAccessRequestRecommendationsViewedItem**](#add-access-request-recommendations-viewed-item) | **POST** `/ai-access-request-recommendations/viewed-items` | Notification of Viewed Access Request Recommendations [**Add-BetaAccessRequestRecommendationsViewedItem**](#add-access-request-recommendations-viewed-item) | **POST** `/ai-access-request-recommendations/viewed-items` | Mark Viewed Access Request Recommendations
[**Add-BetaAccessRequestRecommendationsViewedItems**](#add-access-request-recommendations-viewed-items) | **POST** `/ai-access-request-recommendations/viewed-items/bulk-create` | Notification of Viewed Access Request Recommendations in Bulk [**Add-BetaAccessRequestRecommendationsViewedItems**](#add-access-request-recommendations-viewed-items) | **POST** `/ai-access-request-recommendations/viewed-items/bulk-create` | Bulk Mark Viewed Access Request Recommendations
[**Get-BetaAccessRequestRecommendations**](#get-access-request-recommendations) | **GET** `/ai-access-request-recommendations` | Identity Access Request Recommendations [**Get-BetaAccessRequestRecommendations**](#get-access-request-recommendations) | **GET** `/ai-access-request-recommendations` | Identity Access Request Recommendations
[**Get-BetaAccessRequestRecommendationsIgnoredItems**](#get-access-request-recommendations-ignored-items) | **GET** `/ai-access-request-recommendations/ignored-items` | List of Ignored Access Request Recommendations [**Get-BetaAccessRequestRecommendationsIgnoredItems**](#get-access-request-recommendations-ignored-items) | **GET** `/ai-access-request-recommendations/ignored-items` | List Ignored Access Request Recommendations
[**Get-BetaAccessRequestRecommendationsRequestedItems**](#get-access-request-recommendations-requested-items) | **GET** `/ai-access-request-recommendations/requested-items` | List of Requested Access Request Recommendations [**Get-BetaAccessRequestRecommendationsRequestedItems**](#get-access-request-recommendations-requested-items) | **GET** `/ai-access-request-recommendations/requested-items` | List Accepted Access Request Recommendations
[**Get-BetaAccessRequestRecommendationsViewedItems**](#get-access-request-recommendations-viewed-items) | **GET** `/ai-access-request-recommendations/viewed-items` | List of Viewed Access Request Recommendations [**Get-BetaAccessRequestRecommendationsViewedItems**](#get-access-request-recommendations-viewed-items) | **GET** `/ai-access-request-recommendations/viewed-items` | List Viewed Access Request Recommendations
## add-access-request-recommendations-ignored-item ## add-access-request-recommendations-ignored-item
@@ -64,7 +64,7 @@ $AccessRequestRecommendationActionItemDto = @"{
"identityId" : "2c91808570313110017040b06f344ec9" "identityId" : "2c91808570313110017040b06f344ec9"
}"@ }"@
# Notification of Ignored Access Request Recommendations # Ignore Access Request Recommendation
try { try {
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto $Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
@@ -116,7 +116,7 @@ $AccessRequestRecommendationActionItemDto = @"{
"identityId" : "2c91808570313110017040b06f344ec9" "identityId" : "2c91808570313110017040b06f344ec9"
}"@ }"@
# Notification of Requested Access Request Recommendations # Accept Access Request Recommendation
try { try {
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto $Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
@@ -168,7 +168,7 @@ $AccessRequestRecommendationActionItemDto = @"{
"identityId" : "2c91808570313110017040b06f344ec9" "identityId" : "2c91808570313110017040b06f344ec9"
}"@ }"@
# Notification of Viewed Access Request Recommendations # Mark Viewed Access Request Recommendations
try { try {
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto $Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
@@ -221,7 +221,7 @@ Code | Description | Data Type
}"@ # AccessRequestRecommendationActionItemDto[] | The recommended access items that were viewed for an identity. }"@ # AccessRequestRecommendationActionItemDto[] | The recommended access items that were viewed for an identity.
# Notification of Viewed Access Request Recommendations in Bulk # Bulk Mark Viewed Access Request Recommendations
try { try {
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto $Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
@@ -272,12 +272,12 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$IdentityId = "2c91808570313110017040b06f344ec9" # String | Get access request recommendations for an identityId. *me* indicates the current user. (optional) (default to "me") $IdentityId = "2c91808570313110017040b06f344ec9" # String | Get access request recommendations for an identityId. *me* indicates the current user. (optional) (default to "me")
$Limit = 56 # Int32 | Max number of results to return. (optional) (default to 15) $Limit = 15 # Int32 | Max number of results to return. (optional) (default to 15)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
$IncludeTranslationMessages = $false # Boolean | If *true* it will populate a list of translation messages in the response. (optional) (default to $false) $IncludeTranslationMessages = $false # Boolean | If *true* it will populate a list of translation messages in the response. (optional) (default to $false)
$Filters = 'access.name co "admin"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.name**: *co* **access.type**: *eq, in* **access.description**: *co, eq, in* (optional) $Filters = 'access.name co "admin"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.name**: *co* **access.type**: *eq, in* **access.description**: *co, eq, in* (optional)
$Sorters = "MySorters" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.name, access.type** By default the recommendations are sorted by highest confidence first. (optional) $Sorters = "access.name" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.name, access.type** By default the recommendations are sorted by highest confidence first. (optional)
# Identity Access Request Recommendations # Identity Access Request Recommendations
@@ -332,7 +332,7 @@ $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* respon
$Filters = 'identityId eq "2c9180846b0a0583016b299f210c1314"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.id**: *eq, in* **access.type**: *eq, in* **identityId**: *eq, in* (optional) $Filters = 'identityId eq "2c9180846b0a0583016b299f210c1314"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.id**: *eq, in* **access.type**: *eq, in* **identityId**: *eq, in* (optional)
$Sorters = "access.id" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.id, access.type, identityId, timestamp** (optional) $Sorters = "access.id" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.id, access.type, identityId, timestamp** (optional)
# List of Ignored Access Request Recommendations # List Ignored Access Request Recommendations
try { try {
Get-BetaAccessRequestRecommendationsIgnoredItems Get-BetaAccessRequestRecommendationsIgnoredItems
@@ -383,9 +383,9 @@ $Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Col
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
$Filters = 'access.id eq "2c9180846b0a0583016b299f210c1314"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.id**: *eq, in* **access.type**: *eq, in* **identityId**: *eq, in* (optional) $Filters = 'access.id eq "2c9180846b0a0583016b299f210c1314"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.id**: *eq, in* **access.type**: *eq, in* **identityId**: *eq, in* (optional)
$Sorters = "MySorters" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.id, access.type, identityId, timestamp** (optional) $Sorters = "access.id" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.id, access.type, identityId, timestamp** (optional)
# List of Requested Access Request Recommendations # List Accepted Access Request Recommendations
try { try {
Get-BetaAccessRequestRecommendationsRequestedItems Get-BetaAccessRequestRecommendationsRequestedItems
@@ -436,9 +436,9 @@ $Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Col
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
$Filters = 'access.id eq "2c9180846b0a0583016b299f210c1314"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.id**: *eq, in* **access.type**: *eq, in* **identityId**: *eq, in* (optional) $Filters = 'access.id eq "2c9180846b0a0583016b299f210c1314"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **access.id**: *eq, in* **access.type**: *eq, in* **identityId**: *eq, in* (optional)
$Sorters = "MySorters" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.id, access.type, identityId, timestamp** (optional) $Sorters = "access.id" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **access.id, access.type, identityId, timestamp** (optional)
# List of Viewed Access Request Recommendations # List Viewed Access Request Recommendations
try { try {
Get-BetaAccessRequestRecommendationsViewedItems Get-BetaAccessRequestRecommendationsViewedItems

View File

@@ -17,7 +17,7 @@ All URIs are relative to *https://sailpoint.api.identitynow.com/beta*
Method | HTTP request | Description Method | HTTP request | Description
------------- | ------------- | ------------- ------------- | ------------- | -------------
[**Get-BetaRecommendations**](#get-recommendations) | **POST** `/recommendations/request` | Returns a Recommendation Based on Object [**Get-BetaRecommendations**](#get-recommendations) | **POST** `/recommendations/request` | Returns Recommendation Based on Object
[**Get-BetaRecommendationsConfig**](#get-recommendations-config) | **GET** `/recommendations/config` | Get certification recommendation config values [**Get-BetaRecommendationsConfig**](#get-recommendations-config) | **GET** `/recommendations/config` | Get certification recommendation config values
[**Update-BetaRecommendationsConfig**](#update-recommendations-config) | **PUT** `/recommendations/config` | Update certification recommendation config values [**Update-BetaRecommendationsConfig**](#update-recommendations-config) | **PUT** `/recommendations/config` | Update certification recommendation config values
@@ -71,7 +71,7 @@ $RecommendationRequestDto = @"{
"includeDebugInformation" : true "includeDebugInformation" : true
}"@ }"@
# Returns a Recommendation Based on Object # Returns Recommendation Based on Object
try { try {
$Result = ConvertFrom-JsonToRecommendationRequestDto -Json $RecommendationRequestDto $Result = ConvertFrom-JsonToRecommendationRequestDto -Json $RecommendationRequestDto
@@ -105,6 +105,7 @@ Code | Description | Data Type
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto 400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response 401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto 403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto 500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers ### HTTP request headers
@@ -148,6 +149,7 @@ Code | Description | Data Type
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto 400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response 401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto 403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto 500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers ### HTTP request headers

View File

@@ -24,7 +24,7 @@ Method | HTTP request | Description
## list-requestable-objects ## list-requestable-objects
This endpoint returns a list of acccess items that that can be requested through the Access Request endpoints. Access items are marked with AVAILABLE, PENDING or ASSIGNED with respect to the identity provided using *identity-id* query param. Get a list of acccess items that can be requested through the [Access Request endpoints](https://developer.sailpoint.com/docs/api/v3/access-requests). Access items are marked with `AVAILABLE`, `PENDING` or `ASSIGNED` with respect to the identity provided using `identity-id` query parameter.
Any authenticated token can call this endpoint to see their requestable access items. Any authenticated token can call this endpoint to see their requestable access items.
[API Spec](https://developer.sailpoint.com/docs/api/beta/list-requestable-objects) [API Spec](https://developer.sailpoint.com/docs/api/beta/list-requestable-objects)
@@ -33,9 +33,9 @@ Any authenticated token can call this endpoint to see their requestable access i
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Query | IdentityId | **String** | (optional) | If present, the value returns only requestable objects for the specified identity. * Admin users can call this with any identity ID value. * Non-admin users can only specify *me* or pass their own identity ID value. * If absent, returns a list of all requestable objects for the tenant. Only admin users can make such a call. In this case, the available, pending, assigned accesses will not be annotated in the result. Query | IdentityId | **String** | (optional) | If present, the value returns only requestable objects for the specified identity. * Admin users can call this with any identity ID value. * Non-admin users can only specify *me* or pass their own identity ID value. * If absent, returns a list of all requestable objects for the tenant. Only admin users can make such a call. In this case, the available, pending, assigned accesses will not be annotated in the result.
Query | Types | [**[]RequestableObjectType**](../models/requestable-object-type) | (optional) | Filters the results to the specified type/types, where each type is one of ROLE or ACCESS_PROFILE. If absent, all types are returned. Support for additional types may be added in the future without notice. Query | Types | [**[]RequestableObjectType**](../models/requestable-object-type) | (optional) | Filters the results to the specified type/types, where each type is one of `ROLE` or `ACCESS_PROFILE`. If absent, all types are returned. SailPoint may add support for additional types in the future without notice.
Query | Term | **String** | (optional) | It allows searching requestable access items with a partial match on the name or description. If term is provided, then the *filter* query parameter will be ignored. Query | Term | **String** | (optional) | Allows searching requestable access items with a partial match on the name or description. If `term` is provided, then the API will ignore the `filter` query parameter.
Query | Statuses | [**[]RequestableObjectRequestStatus**](../models/requestable-object-request-status) | (optional) | Filters the result to the specified status/statuses, where each status is one of AVAILABLE, ASSIGNED, or PENDING. It is an error to specify this parameter without also specifying an *identity-id* parameter. Additional statuses may be added in the future without notice. Query | Statuses | [**[]RequestableObjectRequestStatus**](../models/requestable-object-request-status) | (optional) | Filters the result to the specified status/statuses, where each status is one of `AVAILABLE`, `ASSIGNED`, or `PENDING`. Specifying this parameter without also specifying an `identity-id` parameter results in an error. SailPoint may add additional statuses in the future without notice.
Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
@@ -62,13 +62,13 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$IdentityId = "e7eab60924f64aa284175b9fa3309599" # String | If present, the value returns only requestable objects for the specified identity. * Admin users can call this with any identity ID value. * Non-admin users can only specify *me* or pass their own identity ID value. * If absent, returns a list of all requestable objects for the tenant. Only admin users can make such a call. In this case, the available, pending, assigned accesses will not be annotated in the result. (optional) $IdentityId = "e7eab60924f64aa284175b9fa3309599" # String | If present, the value returns only requestable objects for the specified identity. * Admin users can call this with any identity ID value. * Non-admin users can only specify *me* or pass their own identity ID value. * If absent, returns a list of all requestable objects for the tenant. Only admin users can make such a call. In this case, the available, pending, assigned accesses will not be annotated in the result. (optional)
$Types = "ACCESS_PROFILE" # RequestableObjectType[] | Filters the results to the specified type/types, where each type is one of ROLE or ACCESS_PROFILE. If absent, all types are returned. Support for additional types may be added in the future without notice. (optional) $Types = "ACCESS_PROFILE" # RequestableObjectType[] | Filters the results to the specified type/types, where each type is one of `ROLE` or `ACCESS_PROFILE`. If absent, all types are returned. SailPoint may add support for additional types in the future without notice. (optional)
$Types = @"ROLE,ACCESS_PROFILE"@ # RequestableObjectType[] | Filters the results to the specified type/types, where each type is one of ROLE or ACCESS_PROFILE. If absent, all types are returned. Support for additional types may be added in the future without notice. (optional) $Types = @"ROLE,ACCESS_PROFILE"@ # RequestableObjectType[] | Filters the results to the specified type/types, where each type is one of `ROLE` or `ACCESS_PROFILE`. If absent, all types are returned. SailPoint may add support for additional types in the future without notice. (optional)
$Term = "Finance Role" # String | It allows searching requestable access items with a partial match on the name or description. If term is provided, then the *filter* query parameter will be ignored. (optional) $Term = "Finance Role" # String | Allows searching requestable access items with a partial match on the name or description. If `term` is provided, then the API will ignore the `filter` query parameter. (optional)
$Statuses = "AVAILABLE" # RequestableObjectRequestStatus[] | Filters the result to the specified status/statuses, where each status is one of AVAILABLE, ASSIGNED, or PENDING. It is an error to specify this parameter without also specifying an *identity-id* parameter. Additional statuses may be added in the future without notice. (optional) $Statuses = "AVAILABLE" # RequestableObjectRequestStatus[] | Filters the result to the specified status/statuses, where each status is one of `AVAILABLE`, `ASSIGNED`, or `PENDING`. Specifying this parameter without also specifying an `identity-id` parameter results in an error. SailPoint may add additional statuses in the future without notice. (optional)
$Statuses = @"[ASSIGNED, PENDING]"@ # RequestableObjectRequestStatus[] | Filters the result to the specified status/statuses, where each status is one of AVAILABLE, ASSIGNED, or PENDING. It is an error to specify this parameter without also specifying an *identity-id* parameter. Additional statuses may be added in the future without notice. (optional) $Statuses = @"[ASSIGNED, PENDING]"@ # RequestableObjectRequestStatus[] | Filters the result to the specified status/statuses, where each status is one of `AVAILABLE`, `ASSIGNED`, or `PENDING`. Specifying this parameter without also specifying an `identity-id` parameter results in an error. SailPoint may add additional statuses in the future without notice. (optional)
$Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250) $Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)

View File

@@ -59,7 +59,7 @@ Method | HTTP request | Description
[**Remove-BetaRole**](#delete-role) | **DELETE** `/roles/{id}` | Delete a Role [**Remove-BetaRole**](#delete-role) | **DELETE** `/roles/{id}` | Delete a Role
[**Get-BetaRole**](#get-role) | **GET** `/roles/{id}` | Get a Role [**Get-BetaRole**](#get-role) | **GET** `/roles/{id}` | Get a Role
[**Get-BetaRoleAssignedIdentities**](#get-role-assigned-identities) | **GET** `/roles/{id}/assigned-identities` | Identities assigned a Role [**Get-BetaRoleAssignedIdentities**](#get-role-assigned-identities) | **GET** `/roles/{id}/assigned-identities` | Identities assigned a Role
[**Get-BetaRoleEntitlements**](#get-role-entitlements) | **GET** `/roles/{id}/entitlements` | List role&#39;s Entitlements [**Get-BetaRoleEntitlements**](#get-role-entitlements) | **GET** `/roles/{id}/entitlements` | List Role&#39;s Entitlements
[**Get-BetaRoles**](#list-roles) | **GET** `/roles` | List Roles [**Get-BetaRoles**](#list-roles) | **GET** `/roles` | List Roles
[**Update-BetaRole**](#patch-role) | **PATCH** `/roles/{id}` | Patch a specified Role [**Update-BetaRole**](#patch-role) | **PATCH** `/roles/{id}` | Patch a specified Role
@@ -473,17 +473,15 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-role-entitlements ## get-role-entitlements
This API lists the Entitlements associated with a given role. Get a list of entitlements associated with a specified role.
A token with API, ORG_ADMIN, ROLE_ADMIN, or ROLE_SUBADMIN authority is required to call this API.
[API Spec](https://developer.sailpoint.com/docs/api/beta/get-role-entitlements) [API Spec](https://developer.sailpoint.com/docs/api/beta/get-role-entitlements)
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the containing role Path | Id | **String** | True | Containing role's ID.
Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Limit | **Int32** | (optional) (default to 50) | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **attribute**: *eq, sw* **value**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **source.id**: *eq, in* Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **attribute**: *eq, sw* **value**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **source.id**: *eq, in*
@@ -508,14 +506,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$Id = "2c91808a7813090a017814121919ecca" # String | ID of the containing role $Id = "2c91808a7813090a017814121919ecca" # String | Containing role's ID.
$Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250) $Limit = 50 # Int32 | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 50)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
$Filters = 'attribute eq "memberOf"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **attribute**: *eq, sw* **value**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **source.id**: *eq, in* (optional) $Filters = 'attribute eq "memberOf"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **attribute**: *eq, sw* **value**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **source.id**: *eq, in* (optional)
$Sorters = "name,-modified" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, attribute, value, created, modified** (optional) $Sorters = "name,-modified" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, attribute, value, created, modified** (optional)
# List role's Entitlements # List Role's Entitlements
try { try {
Get-BetaRoleEntitlements -Id $Id Get-BetaRoleEntitlements -Id $Id

View File

@@ -43,8 +43,8 @@ Method | HTTP request | Description
## create-search-attribute-config ## create-search-attribute-config
Create and configure extended search attributes. This API accepts an attribute name, an attribute display name and a list of name/value pair associates of application IDs to attribute names. It will then validate the inputs and configure/create and attribute promotion configuration in the Link ObjectConfig. Create and configure extended search attributes. This API accepts an attribute name, an attribute display name and a list of name/value pair associates of application IDs to attribute names. It will then validate the inputs and configure/create the attribute promotion configuration in the Link ObjectConfig.
A token with ORG_ADMIN authority is required to call this API. >**Note: Give searchable attributes unique names. Do not give them the same names used for account attributes or source attributes. Also, do not give them the same names present in account schema for a current or future source, regardless of whether that source is included in the searchable attributes' `applicationAttributes`.**
[API Spec](https://developer.sailpoint.com/docs/api/beta/create-search-attribute-config) [API Spec](https://developer.sailpoint.com/docs/api/beta/create-search-attribute-config)
@@ -143,7 +143,7 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-search-attribute-config ## get-search-attribute-config
Get a list of attribute/application associates currently configured in Identity Security Cloud (ISC). Get a list of attribute/application attributes currently configured in Identity Security Cloud (ISC).
A token with ORG_ADMIN authority is required to call this API. A token with ORG_ADMIN authority is required to call this API.
[API Spec](https://developer.sailpoint.com/docs/api/beta/get-search-attribute-config) [API Spec](https://developer.sailpoint.com/docs/api/beta/get-search-attribute-config)
@@ -151,6 +151,8 @@ A token with ORG_ADMIN authority is required to call this API.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
### Return type ### Return type
[**SearchAttributeConfig[]**](../models/search-attribute-config) [**SearchAttributeConfig[]**](../models/search-attribute-config)
@@ -159,6 +161,7 @@ Param Type | Name | Data Type | Required | Description
Code | Description | Data Type Code | Description | Data Type
------------- | ------------- | ------------- ------------- | ------------- | -------------
200 | List of attribute configurations in ISC. | SearchAttributeConfig[] 200 | List of attribute configurations in ISC. | SearchAttributeConfig[]
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response 401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto 403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response 429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response
@@ -170,6 +173,8 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
# List Extended Search Attributes # List Extended Search Attributes
@@ -177,7 +182,7 @@ try {
Get-BetaSearchAttributeConfig Get-BetaSearchAttributeConfig
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-BetaSearchAttributeConfig # Get-BetaSearchAttributeConfig -Limit $Limit -Offset $Offset
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-BetaSearchAttributeConfig" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-BetaSearchAttributeConfig"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails

View File

@@ -10,7 +10,12 @@ tags: ['SDK', 'Software Development Kit', 'Transforms', 'BetaTransforms']
--- ---
# Transforms # Transforms
Operations for creating, managing, and deleting transforms. The purpose of this API is to expose functionality for the manipulation of Transform objects.
Transforms are a form of configurable objects which define an easy way to manipulate attribute data without having
to write code.
Refer to [Transforms](https://developer.sailpoint.com/docs/extensibility/transforms/) for more information about transforms.
All URIs are relative to *https://sailpoint.api.identitynow.com/beta* All URIs are relative to *https://sailpoint.api.identitynow.com/beta*

View File

@@ -143,6 +143,7 @@ This API completes a work item. Either an admin, or the owning/current user must
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | The ID of the work item Path | Id | **String** | True | The ID of the work item
Body | Body | **String** | (optional) | Body is the request payload to create form definition request
### Return type ### Return type
[**WorkItems**](../models/work-items) [**WorkItems**](../models/work-items)
@@ -152,16 +153,20 @@ Code | Description | Data Type
------------- | ------------- | ------------- ------------- | ------------- | -------------
200 | A WorkItems object | WorkItems 200 | A WorkItems object | WorkItems
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto 400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto 403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto 404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/json - **Accept**: application/json
### Example ### Example
```powershell ```powershell
$Id = "ef38f94347e94562b5bb8424a56397d8" # String | The ID of the work item $Id = "ef38f94347e94562b5bb8424a56397d8" # String | The ID of the work item
$Body = "MyBody" # String | Body is the request payload to create form definition request (optional)
# Complete a Work Item # Complete a Work Item
@@ -169,7 +174,7 @@ try {
Complete-BetaWorkItem -Id $Id Complete-BetaWorkItem -Id $Id
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Complete-BetaWorkItem -Id $Id # Complete-BetaWorkItem -Id $Id -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Complete-BetaWorkItem" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Complete-BetaWorkItem"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -376,15 +381,18 @@ Path | Id | **String** | True | ID of the work item.
Query | OwnerId | **String** | (optional) | ID of the work item owner. Query | OwnerId | **String** | (optional) | ID of the work item owner.
### Return type ### Return type
[**WorkItems[]**](../models/work-items) [**SystemCollectionsHashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0)
### Responses ### Responses
Code | Description | Data Type Code | Description | Data Type
------------- | ------------- | ------------- ------------- | ------------- | -------------
200 | The work item with the given ID. | WorkItems[] 200 | The work item with the given ID. | SystemCollectionsHashtable
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto 400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto 403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto 404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: Not defined
@@ -392,8 +400,8 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$Id = "MyId" # String | ID of the work item. $Id = "2c9180835d191a86015d28455b4a2329" # String | ID of the work item.
$OwnerId = "MyOwnerId" # String | ID of the work item owner. (optional) $OwnerId = "2c9180835d191a86015d28455b4a2329" # String | ID of the work item owner. (optional)
# Get a Work Item # Get a Work Item

View File

@@ -910,7 +910,9 @@ $WorkflowBody = @"{
"trigger" : { "trigger" : {
"displayName" : "displayName", "displayName" : "displayName",
"attributes" : { "attributes" : {
"description" : "description", "description" : "Triggered when an identity's manager attribute changes",
"formDefinitionId" : "Admin_Access_Request_Form",
"attributeToFilter" : "LifecycleState",
"id" : "idn:identity-attributes-changed", "id" : "idn:identity-attributes-changed",
"filter.$" : "$.changes[?(@.attribute == 'manager')]" "filter.$" : "$.changes[?(@.attribute == 'manager')]"
}, },

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'AccessItemApproverDto', 'BetaAccessIt
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who approved the access item request. | [optional] **Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who approved the access item request. | [optional]
**Id** | **String** | ID of identity who approved the access item request. | [optional] **Id** | **String** | ID of the identity who approved the access item request. | [optional]
**Name** | **String** | Human-readable display name of identity who approved the access item request. | [optional] **Name** | **String** | Name of the identity who approved the access item request. | [optional]
## Examples ## Examples

View File

@@ -0,0 +1,39 @@
---
id: beta-access-item-requested-for-dto1
title: AccessItemRequestedForDto1
pagination_label: AccessItemRequestedForDto1
sidebar_label: AccessItemRequestedForDto1
sidebar_class_name: powershellsdk
keywords: ['powershell', 'PowerShell', 'sdk', 'AccessItemRequestedForDto1', 'BetaAccessItemRequestedForDto1']
slug: /tools/sdk/powershell/beta/models/access-item-requested-for-dto1
tags: ['SDK', 'Software Development Kit', 'AccessItemRequestedForDto1', 'BetaAccessItemRequestedForDto1']
---
# AccessItemRequestedForDto1
## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity whom the access item is requested for. | [optional]
**Id** | **String** | ID of the identity whom the access item is requested for. | [optional]
**Name** | **String** | Name of the identity whom the access item is requested for. | [optional]
## Examples
- Prepare the resource
```powershell
$AccessItemRequestedForDto1 = Initialize-PSSailpoint.BetaAccessItemRequestedForDto1 -Type IDENTITY `
-Id 2c4180a46faadee4016fb4e018c20626 `
-Name Robert Robinson
```
- Convert the resource to JSON
```powershell
$AccessItemRequestedForDto1 | ConvertTo-JSON
```
[[Back to top]](#)

View File

@@ -0,0 +1,39 @@
---
id: beta-access-item-requester-dto1
title: AccessItemRequesterDto1
pagination_label: AccessItemRequesterDto1
sidebar_label: AccessItemRequesterDto1
sidebar_class_name: powershellsdk
keywords: ['powershell', 'PowerShell', 'sdk', 'AccessItemRequesterDto1', 'BetaAccessItemRequesterDto1']
slug: /tools/sdk/powershell/beta/models/access-item-requester-dto1
tags: ['SDK', 'Software Development Kit', 'AccessItemRequesterDto1', 'BetaAccessItemRequesterDto1']
---
# AccessItemRequesterDto1
## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | Access item requester's DTO type. | [optional]
**Id** | **String** | Access item requester's identity ID. | [optional]
**Name** | **String** | Access item requester's name. | [optional]
## Examples
- Prepare the resource
```powershell
$AccessItemRequesterDto1 = Initialize-PSSailpoint.BetaAccessItemRequesterDto1 -Type IDENTITY `
-Id 2c7180a46faadee4016fb4e018c20648 `
-Name William Wilson
```
- Convert the resource to JSON
```powershell
$AccessItemRequesterDto1 | ConvertTo-JSON
```
[[Back to top]](#)

View File

@@ -21,7 +21,7 @@ Name | Type | Description | Notes
**Description** | **String** | Information about the Access Profile | [optional] **Description** | **String** | Information about the Access Profile | [optional]
**Created** | **System.DateTime** | Date the Access Profile was created | [optional] [readonly] **Created** | **System.DateTime** | Date the Access Profile was created | [optional] [readonly]
**Modified** | **System.DateTime** | Date the Access Profile was last modified. | [optional] [readonly] **Modified** | **System.DateTime** | Date the Access Profile was last modified. | [optional] [readonly]
**Enabled** | **Boolean** | Whether the Access Profile is enabled. If the Access Profile is enabled then you must include at least one Entitlement. | [optional] [default to $true] **Enabled** | **Boolean** | Whether the Access Profile is enabled. If the Access Profile is enabled then you must include at least one Entitlement. | [optional] [default to $false]
**Owner** | [**OwnerReference**](owner-reference) | | [required] **Owner** | [**OwnerReference**](owner-reference) | | [required]
**Source** | [**AccessProfileSourceRef**](access-profile-source-ref) | | [required] **Source** | [**AccessProfileSourceRef**](access-profile-source-ref) | | [required]
**Entitlements** | [**[]EntitlementRef**](entitlement-ref) | A list of entitlements associated with the Access Profile. If enabled is false this is allowed to be empty otherwise it needs to contain at least one Entitlement. | [optional] **Entitlements** | [**[]EntitlementRef**](entitlement-ref) | A list of entitlements associated with the Access Profile. If enabled is false this is allowed to be empty otherwise it needs to contain at least one Entitlement. | [optional]

View File

@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestDynamicApprover', 'BetaA
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**AccessRequestId** | **String** | The unique ID of the access request object. Can be used with the [access request status endpoint](https://developer.sailpoint.com/idn/api/beta/list-access-request-status) to get the status of the request. | [required] **AccessRequestId** | **String** | Unique ID of the access request object. You can use this ID with the [Access Request Status endpoint](https://developer.sailpoint.com/idn/api/beta/list-access-request-status) to get the request's status. | [required]
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required] **RequestedFor** | [**[]AccessItemRequestedForDto1**](access-item-requested-for-dto1) | Identities access was requested for. | [required]
**RequestedItems** | [**[]AccessRequestDynamicApproverRequestedItemsInner**](access-request-dynamic-approver-requested-items-inner) | The access items that are being requested. | [required] **RequestedItems** | [**[]AccessRequestDynamicApproverRequestedItemsInner**](access-request-dynamic-approver-requested-items-inner) | Requested access items. | [required]
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required] **RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
## Examples ## Examples

View File

@@ -16,12 +16,12 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestDynamicApproverRequested
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the access item. | [required] **Id** | **String** | Access item's unique identifier. | [required]
**Name** | **String** | Human friendly name of the access item. | [required] **Name** | **String** | Access item's name. | [required]
**Description** | **String** | Extended description of the access item. | [optional] **Description** | **String** | Access item's extended description. | [optional]
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | The type of access item being requested. | [required] **Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | Type of access item being requested. | [required]
**Operation** | **Enum** [ "Add", "Remove" ] | Grant or revoke the access item | [required] **Operation** | **Enum** [ "Add", "Remove" ] | Action to perform on the requested access item. | [required]
**Comment** | **String** | A comment from the requestor on why the access is needed. | [optional] **Comment** | **String** | Comment from the requester about why the access is necessary. | [optional]
## Examples ## Examples

View File

@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApproval', 'BetaAcce
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**AccessRequestId** | **String** | The unique ID of the access request. | [required] **AccessRequestId** | **String** | Access request's unique ID. | [required]
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required] **RequestedFor** | [**[]AccessItemRequestedForDto1**](access-item-requested-for-dto1) | Identities whom access was requested for. | [required]
**RequestedItemsStatus** | [**[]AccessRequestPostApprovalRequestedItemsStatusInner**](access-request-post-approval-requested-items-status-inner) | Details on the outcome of each access item. | [required] **RequestedItemsStatus** | [**[]AccessRequestPostApprovalRequestedItemsStatusInner**](access-request-post-approval-requested-items-status-inner) | Details about the outcome of each requested access item. | [required]
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required] **RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
## Examples ## Examples

View File

@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApprovalRequestedIte
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the access item being requested. | [required] **Id** | **String** | Access item's unique ID. | [required]
**Name** | **String** | The human friendly name of the access item. | [required] **Name** | **String** | Access item's name. | [required]
**Description** | **String** | Detailed description of the access item. | [optional] **Description** | **String** | Access item's description. | [optional]
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | The type of access item. | [required] **Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | Access item's type. | [required]
**Operation** | **Enum** [ "Add", "Remove" ] | The action to perform on the access item. | [required] **Operation** | **Enum** [ "Add", "Remove" ] | Action to perform on the requested access item. | [required]
**Comment** | **String** | A comment from the identity requesting the access. | [optional] **Comment** | **String** | Comment from the identity requesting access. | [optional]
**ClientMetadata** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Additional customer defined metadata about the access item. | [optional] **ClientMetadata** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Additional customer defined metadata about the access item. | [optional]
**ApprovalInfo** | [**[]AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInner**](access-request-post-approval-requested-items-status-inner-approval-info-inner) | A list of one or more approvers for the access request. | [required] **ApprovalInfo** | [**[]AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInner**](access-request-post-approval-requested-items-status-inner-approval-info-inner) | List of approvers for the access request. | [required]
## Examples ## Examples

View File

@@ -16,16 +16,16 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApprovalRequestedIte
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**ApprovalComment** | **String** | A comment left by the approver. | [optional] **ApprovalComment** | **String** | Approver's comment. | [optional]
**ApprovalDecision** | **Enum** [ "APPROVED", "DENIED" ] | The final decision of the approver. | [required] **ApprovalDecision** | **Enum** [ "APPROVED", "DENIED" ] | Approver's final decision. | [required]
**ApproverName** | **String** | The name of the approver | [required] **ApproverName** | **String** | Approver's name. | [required]
**Approver** | [**AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover**](access-request-post-approval-requested-items-status-inner-approval-info-inner-approver) | | [required] **Approver** | [**AccessItemApproverDto**](access-item-approver-dto) | Approver's identity. | [required]
## Examples ## Examples
- Prepare the resource - Prepare the resource
```powershell ```powershell
$AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInner = Initialize-PSSailpoint.BetaAccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInner -ApprovalComment This access looks good. Approved. ` $AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInner = Initialize-PSSailpoint.BetaAccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInner -ApprovalComment This access looks good. Approved. `
-ApprovalDecision APPROVED ` -ApprovalDecision APPROVED `
-ApproverName Stephen.Austin ` -ApproverName Stephen.Austin `
-Approver null -Approver null

View File

@@ -1,39 +0,0 @@
---
id: beta-access-request-post-approval-requested-items-status-inner-approval-info-inner-approver
title: AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover
pagination_label: AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover
sidebar_label: AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover
sidebar_class_name: powershellsdk
keywords: ['powershell', 'PowerShell', 'sdk', 'AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover', 'BetaAccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover']
slug: /tools/sdk/powershell/beta/models/access-request-post-approval-requested-items-status-inner-approval-info-inner-approver
tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover', 'BetaAccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover']
---
# AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover
## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | The type of object that is referenced | [required]
**Id** | **String** | ID of identity who approved the access item request. | [required]
**Name** | **String** | Human-readable display name of identity who approved the access item request. | [required]
## Examples
- Prepare the resource
```powershell
$AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover = Initialize-PSSailpoint.BetaAccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover -Type IDENTITY `
-Id 2c3780a46faadee4016fb4e018c20652 `
-Name Allen Albertson
```
- Convert the resource to JSON
```powershell
$AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover | ConvertTo-JSON
```
[[Back to top]](#)

View File

@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPreApproval', 'BetaAcces
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**AccessRequestId** | **String** | The unique ID of the access request. | [required] **AccessRequestId** | **String** | Access request's unique ID. | [required]
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required] **RequestedFor** | [**[]AccessItemRequestedForDto1**](access-item-requested-for-dto1) | Identities whom access was requested for. | [required]
**RequestedItems** | [**[]AccessRequestPreApprovalRequestedItemsInner**](access-request-pre-approval-requested-items-inner) | Details of the access items being requested. | [required] **RequestedItems** | [**[]AccessRequestPreApprovalRequestedItemsInner**](access-request-pre-approval-requested-items-inner) | Details about each requested access item. | [required]
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required] **RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
## Examples ## Examples

View File

@@ -16,12 +16,12 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPreApprovalRequestedItem
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the access item being requested. | [required] **Id** | **String** | Access item's unique ID. | [required]
**Name** | **String** | The human friendly name of the access item. | [required] **Name** | **String** | Access item's name. | [required]
**Description** | **String** | Detailed description of the access item. | [optional] **Description** | **String** | Access item's description. | [optional]
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | The type of access item. | [required] **Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | Access item's type. | [required]
**Operation** | **Enum** [ "Add", "Remove" ] | The action to perform on the access item. | [required] **Operation** | **Enum** [ "Add", "Remove" ] | Action to perform on the access item. | [required]
**Comment** | **String** | A comment from the identity requesting the access. | [optional] **Comment** | **String** | Comment from the identity requesting access. | [optional]
## Examples ## Examples

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**RequestedFor** | **String** | The identity id in which the access request is for. | [optional] **RequestedFor** | **String** | The identity id in which the access request is for. | [optional]
**RequestedItemsDetails** | [**[]RequestedItemDetails**](requested-item-details) | The details of the item requested. | [optional] **RequestedItemsDetails** | [**[]RequestedItemDetails**](requested-item-details) | The details of the item requested. | [optional]
**AttributesHash** | **String** | a hash representation of the access requested, useful for longer term tracking client side. | [optional] **AttributesHash** | **Int32** | a hash representation of the access requested, useful for longer term tracking client side. | [optional]
**AccessRequestIds** | **[]String** | a list of access request identifiers, generally only one will be populated, but high volume requested may result in multiple ids. | [optional] **AccessRequestIds** | **[]String** | a list of access request identifiers, generally only one will be populated, but high volume requested may result in multiple ids. | [optional]
## Examples ## Examples

View File

@@ -17,11 +17,11 @@ tags: ['SDK', 'Software Development Kit', 'AccountAggregationCompleted', 'BetaAc
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Source** | [**AccountAggregationCompletedSource**](account-aggregation-completed-source) | | [required] **Source** | [**AccountAggregationCompletedSource**](account-aggregation-completed-source) | | [required]
**Status** | **Enum** [ "Success", "Failed", "Terminated" ] | The overall status of the aggregation. | [required] **Status** | **Enum** [ "Success", "Failed", "Terminated" ] | Aggregation's overall status. | [required]
**Started** | **System.DateTime** | The date and time when the account aggregation started. | [required] **Started** | **System.DateTime** | Date and time when the account aggregation started. | [required]
**Completed** | **System.DateTime** | The date and time when the account aggregation finished. | [required] **Completed** | **System.DateTime** | Date and time when the account aggregation finished. | [required]
**Errors** | **[]String** | A list of errors that occurred during the aggregation. | [required] **Errors** | **[]String** | List of errors that occurred during the aggregation. | [required]
**Warnings** | **[]String** | A list of warnings that occurred during the aggregation. | [required] **Warnings** | **[]String** | List of warnings that occurred during the aggregation. | [required]
**Stats** | [**AccountAggregationCompletedStats**](account-aggregation-completed-stats) | | [required] **Stats** | [**AccountAggregationCompletedStats**](account-aggregation-completed-stats) | | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'AccountAggregationCompletedSource', '
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "SOURCE" ] | The DTO type of the source the accounts are being aggregated from. | [required] **Type** | **Enum** [ "SOURCE" ] | Source's DTO type. | [required]
**Id** | **String** | The ID of the source the accounts are being aggregated from. | [required] **Id** | **String** | Source's unique ID. | [required]
**Name** | **String** | Display name of the source the accounts are being aggregated from. | [required] **Name** | **String** | Source's name. | [required]
## Examples ## Examples

View File

@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'AccountAggregationCompletedStats', 'B
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Scanned** | **Int32** | The number of accounts which were scanned / iterated over. | [required] **Scanned** | **Int32** | Number of accounts scanned/iterated over. | [required]
**Unchanged** | **Int32** | The number of accounts which existed before, but had no changes. | [required] **Unchanged** | **Int32** | Number of accounts that existed before but had no changes. | [required]
**Changed** | **Int32** | The number of accounts which existed before, but had changes. | [required] **Changed** | **Int32** | Number of accounts that existed before but had changes. | [required]
**Added** | **Int32** | The number of accounts which are new - have not existed before. | [required] **Added** | **Int32** | Number of accounts that are new and didn't previously exist. | [required]
**Removed** | **Int32** | The number accounts which existed before, but no longer exist (thus getting removed). | [required] **Removed** | **Int32** | Number accounts that existed before but were removed and no longer exist. | [required]
## Examples ## Examples

View File

@@ -16,15 +16,15 @@ tags: ['SDK', 'Software Development Kit', 'CampaignActivatedCampaign', 'BetaCamp
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | Unique ID for the campaign. | [required] **Id** | **String** | Campaign's unique ID. | [required]
**Name** | **String** | The human friendly name of the campaign. | [required] **Name** | **String** | Campaign's name. | [required]
**Description** | **String** | Extended description of the campaign. | [required] **Description** | **String** | Campaign's extended description. | [required]
**Created** | **System.DateTime** | The date and time the campaign was created. | [required] **Created** | **System.DateTime** | Date and time when the campaign was created. | [required]
**Modified** | **System.DateTime** | The date and time the campaign was last modified. | [optional] **Modified** | **System.DateTime** | Date and time when the campaign was last modified. | [optional]
**Deadline** | **System.DateTime** | The date and time the campaign is due. | [required] **Deadline** | **System.DateTime** | Date and time when the campaign is due. | [required]
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | The type of campaign. | [required] **Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | Campaign's type. | [required]
**CampaignOwner** | [**CampaignActivatedCampaignCampaignOwner**](campaign-activated-campaign-campaign-owner) | | [required] **CampaignOwner** | [**CampaignActivatedCampaignCampaignOwner**](campaign-activated-campaign-campaign-owner) | | [required]
**Status** | **Enum** [ "ACTIVE" ] | The current status of the campaign. | [required] **Status** | **Enum** [ "ACTIVE" ] | Campaign's current status. | [required]
## Examples ## Examples

View File

@@ -16,17 +16,17 @@ tags: ['SDK', 'Software Development Kit', 'CampaignActivatedCampaignCampaignOwne
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the identity. | [required] **Id** | **String** | Identity's unique ID. | [required]
**DisplayName** | **String** | The human friendly name of the identity. | [required] **DisplayName** | **String** | Identity's name. | [required]
**Email** | **String** | The primary email address of the identity. | [required] **Email** | **String** | Identity's primary email address. | [required]
## Examples ## Examples
- Prepare the resource - Prepare the resource
```powershell ```powershell
$CampaignActivatedCampaignCampaignOwner = Initialize-PSSailpoint.BetaCampaignActivatedCampaignCampaignOwner -Id 37f080867702c1910177031320c40n27 ` $CampaignActivatedCampaignCampaignOwner = Initialize-PSSailpoint.BetaCampaignActivatedCampaignCampaignOwner -Id 37f080867702c1910177031320c40n27 `
-DisplayName John Snow ` -DisplayName Albert Albertson `
-Email john.snow@example.com -Email albert.albertson@example.com
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -16,15 +16,15 @@ tags: ['SDK', 'Software Development Kit', 'CampaignEndedCampaign', 'BetaCampaign
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | Unique ID for the campaign. | [required] **Id** | **String** | Campaign's unique ID for the campaign. | [required]
**Name** | **String** | The human friendly name of the campaign. | [required] **Name** | **String** | Campaign's unique ID. | [required]
**Description** | **String** | Extended description of the campaign. | [required] **Description** | **String** | Campaign's extended description. | [required]
**Created** | **System.DateTime** | The date and time the campaign was created. | [required] **Created** | **System.DateTime** | Date and time when the campaign was created. | [required]
**Modified** | **System.DateTime** | The date and time the campaign was last modified. | [optional] **Modified** | **System.DateTime** | Date and time when the campaign was last modified. | [optional]
**Deadline** | **System.DateTime** | The date and time the campaign is due. | [required] **Deadline** | **System.DateTime** | Date and time when the campaign is due. | [required]
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | The type of campaign. | [required] **Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | Campaign's type. | [required]
**CampaignOwner** | [**CampaignActivatedCampaignCampaignOwner**](campaign-activated-campaign-campaign-owner) | | [required] **CampaignOwner** | [**CampaignActivatedCampaignCampaignOwner**](campaign-activated-campaign-campaign-owner) | | [required]
**Status** | **Enum** [ "COMPLETED" ] | The current status of the campaign. | [required] **Status** | **Enum** [ "COMPLETED" ] | Campaign's current status. | [required]
## Examples ## Examples

View File

@@ -16,15 +16,15 @@ tags: ['SDK', 'Software Development Kit', 'CampaignGeneratedCampaign', 'BetaCamp
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the campaign. | [required] **Id** | **String** | Campaign's unique ID. | [required]
**Name** | **String** | Human friendly name of the campaign. | [required] **Name** | **String** | Campaign's name. | [required]
**Description** | **String** | Extended description of the campaign. | [required] **Description** | **String** | Campaign's extended description. | [required]
**Created** | **System.DateTime** | The date and time the campaign was created. | [required] **Created** | **System.DateTime** | Date and time when the campaign was created. | [required]
**Modified** | **String** | The date and time the campaign was last modified. | [optional] **Modified** | **String** | Date and time when the campaign was last modified. | [optional]
**Deadline** | **String** | The date and time when the campaign must be finished by. | [optional] **Deadline** | **String** | Date and time when the campaign must be finished. | [optional]
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | The type of campaign that was generated. | [required] **Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | Campaign's type. | [required]
**CampaignOwner** | [**CampaignGeneratedCampaignCampaignOwner**](campaign-generated-campaign-campaign-owner) | | [required] **CampaignOwner** | [**CampaignGeneratedCampaignCampaignOwner**](campaign-generated-campaign-campaign-owner) | | [required]
**Status** | **Enum** [ "STAGED", "ACTIVATING", "ACTIVE" ] | The current status of the campaign. | [required] **Status** | **Enum** [ "STAGED", "ACTIVATING", "ACTIVE" ] | Campaign's current status. | [required]
## Examples ## Examples

View File

@@ -16,17 +16,17 @@ tags: ['SDK', 'Software Development Kit', 'CampaignGeneratedCampaignCampaignOwne
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the identity. | [required] **Id** | **String** | Identity's unique ID. | [required]
**DisplayName** | **String** | The display name of the identity. | [required] **DisplayName** | **String** | Identity's name. | [required]
**Email** | **String** | The primary email address of the identity. | [required] **Email** | **String** | Identity's primary email address. | [required]
## Examples ## Examples
- Prepare the resource - Prepare the resource
```powershell ```powershell
$CampaignGeneratedCampaignCampaignOwner = Initialize-PSSailpoint.BetaCampaignGeneratedCampaignCampaignOwner -Id 37f080867702c1910177031320c40n27 ` $CampaignGeneratedCampaignCampaignOwner = Initialize-PSSailpoint.BetaCampaignGeneratedCampaignCampaignOwner -Id 37f080867702c1910177031320c40n27 `
-DisplayName John Snow ` -DisplayName Albert Albertson `
-Email john.snow@example.com -Email albert.albertson@example.com
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -18,17 +18,17 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**CampaignRef** | [**CampaignReference**](campaign-reference) | | [required] **CampaignRef** | [**CampaignReference**](campaign-reference) | | [required]
**Phase** | [**CertificationPhase**](certification-phase) | | [required] **Phase** | [**CertificationPhase**](certification-phase) | | [required]
**Due** | **System.DateTime** | The due date of the certification. | [required] **Due** | **System.DateTime** | Date and time when the certification is due. | [required]
**Signed** | **System.DateTime** | The date the reviewer signed off on the certification. | [required] **Signed** | **System.DateTime** | Date and time when the reviewer signed off on the certification. | [required]
**Reviewer** | [**Reviewer**](reviewer) | | [required] **Reviewer** | [**Reviewer**](reviewer) | | [required]
**Reassignment** | [**Reassignment**](reassignment) | | [optional] **Reassignment** | [**Reassignment**](reassignment) | | [optional]
**HasErrors** | **Boolean** | Indicates it the certification has any errors. | [required] **HasErrors** | **Boolean** | Indicates whether the certification has any errors. | [required]
**ErrorMessage** | **String** | A message indicating what the error is. | [optional] **ErrorMessage** | **String** | Message indicating what the error is. | [optional]
**Completed** | **Boolean** | Indicates if all certification decisions have been made. | [required] **Completed** | **Boolean** | Indicates whether all certification decisions have been made. | [required]
**DecisionsMade** | **Int32** | The number of approve/revoke/acknowledge decisions that have been made by the reviewer. | [required] **DecisionsMade** | **Int32** | Number of approve/revoke/acknowledge decisions the reviewer has made. | [required]
**DecisionsTotal** | **Int32** | The total number of approve/revoke/acknowledge decisions for the certification. | [required] **DecisionsTotal** | **Int32** | Total number of approve/revoke/acknowledge decisions for the certification. | [required]
**EntitiesCompleted** | **Int32** | The number of entities (identities, access profiles, roles, etc.) for which all decisions have been made and are complete. | [required] **EntitiesCompleted** | **Int32** | Number of entities (identities, access profiles, roles, etc.) that are complete and all decisions have been made for. | [required]
**EntitiesTotal** | **Int32** | The total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required] **EntitiesTotal** | **Int32** | Total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required]
## Examples ## Examples

View File

@@ -16,23 +16,23 @@ tags: ['SDK', 'Software Development Kit', 'CertificationSignedOffCertification',
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | Unique ID of the certification. | [required] **Id** | **String** | Certification's unique ID. | [required]
**Name** | **String** | The name of the certification. | [required] **Name** | **String** | Certification's name. | [required]
**Created** | **System.DateTime** | The date and time the certification was created. | [required] **Created** | **System.DateTime** | Date and time when the certification was created. | [required]
**Modified** | **System.DateTime** | The date and time the certification was last modified. | [optional] **Modified** | **System.DateTime** | Date and time when the certification was last modified. | [optional]
**CampaignRef** | [**CampaignReference**](campaign-reference) | | [required] **CampaignRef** | [**CampaignReference**](campaign-reference) | | [required]
**Phase** | [**CertificationPhase**](certification-phase) | | [required] **Phase** | [**CertificationPhase**](certification-phase) | | [required]
**Due** | **System.DateTime** | The due date of the certification. | [required] **Due** | **System.DateTime** | Date and time when the certification is due. | [required]
**Signed** | **System.DateTime** | The date the reviewer signed off on the certification. | [required] **Signed** | **System.DateTime** | Date and time when the reviewer signed off on the certification. | [required]
**Reviewer** | [**Reviewer**](reviewer) | | [required] **Reviewer** | [**Reviewer**](reviewer) | | [required]
**Reassignment** | [**Reassignment**](reassignment) | | [optional] **Reassignment** | [**Reassignment**](reassignment) | | [optional]
**HasErrors** | **Boolean** | Indicates it the certification has any errors. | [required] **HasErrors** | **Boolean** | Indicates whether the certification has any errors. | [required]
**ErrorMessage** | **String** | A message indicating what the error is. | [optional] **ErrorMessage** | **String** | Message indicating what the error is. | [optional]
**Completed** | **Boolean** | Indicates if all certification decisions have been made. | [required] **Completed** | **Boolean** | Indicates whether all certification decisions have been made. | [required]
**DecisionsMade** | **Int32** | The number of approve/revoke/acknowledge decisions that have been made by the reviewer. | [required] **DecisionsMade** | **Int32** | Number of approve/revoke/acknowledge decisions the reviewer has made. | [required]
**DecisionsTotal** | **Int32** | The total number of approve/revoke/acknowledge decisions for the certification. | [required] **DecisionsTotal** | **Int32** | Total number of approve/revoke/acknowledge decisions for the certification. | [required]
**EntitiesCompleted** | **Int32** | The number of entities (identities, access profiles, roles, etc.) for which all decisions have been made and are complete. | [required] **EntitiesCompleted** | **Int32** | Number of entities (identities, access profiles, roles, etc.) that are complete and all decisions have been made for. | [required]
**EntitiesTotal** | **Int32** | The total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required] **EntitiesTotal** | **Int32** | Total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required]
## Examples ## Examples

View File

@@ -39,6 +39,7 @@ Name | Type | Description | Notes
**SodViolationContext** | [**SodViolationContextCheckCompleted1**](sod-violation-context-check-completed1) | | [optional] **SodViolationContext** | [**SodViolationContextCheckCompleted1**](sod-violation-context-check-completed1) | | [optional]
**PreApprovalTriggerResult** | [**CompletedApprovalPreApprovalTriggerResult**](completed-approval-pre-approval-trigger-result) | | [optional] **PreApprovalTriggerResult** | [**CompletedApprovalPreApprovalTriggerResult**](completed-approval-pre-approval-trigger-result) | | [optional]
**ClientMetadata** | **map[string]String** | Arbitrary key-value pairs provided during the request. | [optional] **ClientMetadata** | **map[string]String** | Arbitrary key-value pairs provided during the request. | [optional]
**RequestedAccounts** | [**[]RequestedAccountRef**](requested-account-ref) | The accounts selected by the user for the access to be provisioned on, in case they have multiple accounts on one or more sources. | [optional]
## Examples ## Examples
@@ -66,7 +67,8 @@ $CompletedApproval = Initialize-PSSailpoint.BetaCompletedApproval -Id 2c9380836
-CurrentRemoveDate 2020-07-11T00:00Z ` -CurrentRemoveDate 2020-07-11T00:00Z `
-SodViolationContext null ` -SodViolationContext null `
-PreApprovalTriggerResult null ` -PreApprovalTriggerResult null `
-ClientMetadata {requestedAppName=test-app, requestedAppId=2c91808f7892918f0178b78da4a305a1} -ClientMetadata {requestedAppName=test-app, requestedAppId=2c91808f7892918f0178b78da4a305a1} `
-RequestedAccounts null
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Name** | **String** | the name of the rule | [required] **Name** | **String** | the name of the rule | [required]
**Description** | **String** | a description of the rule's purpose | [optional] **Description** | **String** | a description of the rule's purpose | [optional]
**Type** | **Enum** [ "BuildMap", "ConnectorAfterCreate", "ConnectorAfterDelete", "ConnectorAfterModify", "ConnectorBeforeCreate", "ConnectorBeforeDelete", "ConnectorBeforeModify", "JDBCBuildMap", "JDBCOperationProvisioning", "JDBCProvision", "PeopleSoftHRMSBuildMap", "PeopleSoftHRMSOperationProvisioning", "PeopleSoftHRMSProvision", "RACFPermissionCustomization", "SAPBuildMap", "SapHrManagerRule", "SapHrOperationProvisioning", "SapHrProvision", "SuccessFactorsOperationProvisioning", "WebServiceAfterOperationRule", "WebServiceBeforeOperationRule" ] | the type of rule | [required] **Type** | **Enum** [ "BuildMap", "ConnectorAfterCreate", "ConnectorAfterDelete", "ConnectorAfterModify", "ConnectorBeforeCreate", "ConnectorBeforeDelete", "ConnectorBeforeModify", "JDBCBuildMap", "JDBCOperationProvisioning", "JDBCProvision", "PeopleSoftHRMSBuildMap", "PeopleSoftHRMSOperationProvisioning", "PeopleSoftHRMSProvision", "RACFPermissionCustomization", "SAPBuildMap", "SapHrManagerRule", "SapHrOperationProvisioning", "SapHrProvision", "SuccessFactorsOperationProvisioning", "WebServiceAfterOperationRule", "WebServiceBeforeOperationRule", "ResourceObjectCustomization" ] | the type of rule | [required]
**Signature** | [**ConnectorRuleCreateRequestSignature**](connector-rule-create-request-signature) | | [optional] **Signature** | [**ConnectorRuleCreateRequestSignature**](connector-rule-create-request-signature) | | [optional]
**SourceCode** | [**SourceCode**](source-code) | | [required] **SourceCode** | [**SourceCode**](source-code) | | [required]
**Attributes** | [**SystemCollectionsHashtable**]https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0 | a map of string to objects | [optional] **Attributes** | [**SystemCollectionsHashtable**]https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0 | a map of string to objects | [optional]

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Name** | **String** | the name of the rule | [required] **Name** | **String** | the name of the rule | [required]
**Description** | **String** | a description of the rule's purpose | [optional] **Description** | **String** | a description of the rule's purpose | [optional]
**Type** | **Enum** [ "BuildMap", "ConnectorAfterCreate", "ConnectorAfterDelete", "ConnectorAfterModify", "ConnectorBeforeCreate", "ConnectorBeforeDelete", "ConnectorBeforeModify", "JDBCBuildMap", "JDBCOperationProvisioning", "JDBCProvision", "PeopleSoftHRMSBuildMap", "PeopleSoftHRMSOperationProvisioning", "PeopleSoftHRMSProvision", "RACFPermissionCustomization", "SAPBuildMap", "SapHrManagerRule", "SapHrOperationProvisioning", "SapHrProvision", "SuccessFactorsOperationProvisioning", "WebServiceAfterOperationRule", "WebServiceBeforeOperationRule" ] | the type of rule | [required] **Type** | **Enum** [ "BuildMap", "ConnectorAfterCreate", "ConnectorAfterDelete", "ConnectorAfterModify", "ConnectorBeforeCreate", "ConnectorBeforeDelete", "ConnectorBeforeModify", "JDBCBuildMap", "JDBCOperationProvisioning", "JDBCProvision", "PeopleSoftHRMSBuildMap", "PeopleSoftHRMSOperationProvisioning", "PeopleSoftHRMSProvision", "RACFPermissionCustomization", "SAPBuildMap", "SapHrManagerRule", "SapHrOperationProvisioning", "SapHrProvision", "SuccessFactorsOperationProvisioning", "WebServiceAfterOperationRule", "WebServiceBeforeOperationRule", "ResourceObjectCustomization" ] | the type of rule | [required]
**Signature** | [**ConnectorRuleCreateRequestSignature**](connector-rule-create-request-signature) | | [optional] **Signature** | [**ConnectorRuleCreateRequestSignature**](connector-rule-create-request-signature) | | [optional]
**SourceCode** | [**SourceCode**](source-code) | | [required] **SourceCode** | [**SourceCode**](source-code) | | [required]
**Attributes** | [**SystemCollectionsHashtable**]https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0 | a map of string to objects | [optional] **Attributes** | [**SystemCollectionsHashtable**]https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0 | a map of string to objects | [optional]

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Name** | **String** | the name of the rule | [required] **Name** | **String** | the name of the rule | [required]
**Description** | **String** | a description of the rule's purpose | [optional] **Description** | **String** | a description of the rule's purpose | [optional]
**Type** | **Enum** [ "BuildMap", "ConnectorAfterCreate", "ConnectorAfterDelete", "ConnectorAfterModify", "ConnectorBeforeCreate", "ConnectorBeforeDelete", "ConnectorBeforeModify", "JDBCBuildMap", "JDBCOperationProvisioning", "JDBCProvision", "PeopleSoftHRMSBuildMap", "PeopleSoftHRMSOperationProvisioning", "PeopleSoftHRMSProvision", "RACFPermissionCustomization", "SAPBuildMap", "SapHrManagerRule", "SapHrOperationProvisioning", "SapHrProvision", "SuccessFactorsOperationProvisioning", "WebServiceAfterOperationRule", "WebServiceBeforeOperationRule" ] | the type of rule | [required] **Type** | **Enum** [ "BuildMap", "ConnectorAfterCreate", "ConnectorAfterDelete", "ConnectorAfterModify", "ConnectorBeforeCreate", "ConnectorBeforeDelete", "ConnectorBeforeModify", "JDBCBuildMap", "JDBCOperationProvisioning", "JDBCProvision", "PeopleSoftHRMSBuildMap", "PeopleSoftHRMSOperationProvisioning", "PeopleSoftHRMSProvision", "RACFPermissionCustomization", "SAPBuildMap", "SapHrManagerRule", "SapHrOperationProvisioning", "SapHrProvision", "SuccessFactorsOperationProvisioning", "WebServiceAfterOperationRule", "WebServiceBeforeOperationRule", "ResourceObjectCustomization" ] | the type of rule | [required]
**Signature** | [**ConnectorRuleCreateRequestSignature**](connector-rule-create-request-signature) | | [optional] **Signature** | [**ConnectorRuleCreateRequestSignature**](connector-rule-create-request-signature) | | [optional]
**SourceCode** | [**SourceCode**](source-code) | | [required] **SourceCode** | [**SourceCode**](source-code) | | [required]
**Attributes** | [**SystemCollectionsHashtable**]https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0 | a map of string to objects | [optional] **Attributes** | [**SystemCollectionsHashtable**]https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0 | a map of string to objects | [optional]

View File

@@ -19,6 +19,8 @@ Name | Type | Description | Notes
**Id** | **String** | The unique ID of the trigger | [required] **Id** | **String** | The unique ID of the trigger | [required]
**VarFilter** | **String** | JSON path expression that will limit which events the trigger will fire on | [optional] **VarFilter** | **String** | JSON path expression that will limit which events the trigger will fire on | [optional]
**Description** | **String** | Description of the event trigger | [optional] **Description** | **String** | Description of the event trigger | [optional]
**AttributeToFilter** | **String** | The attribute to filter on | [optional]
**FormDefinitionId** | **String** | Form definition's unique identifier. | [optional]
## Examples ## Examples
@@ -26,7 +28,9 @@ Name | Type | Description | Notes
```powershell ```powershell
$EventAttributes = Initialize-PSSailpoint.BetaEventAttributes -Id idn:identity-attributes-changed ` $EventAttributes = Initialize-PSSailpoint.BetaEventAttributes -Id idn:identity-attributes-changed `
-VarFilter $.changes[?(@.attribute == 'manager')] ` -VarFilter $.changes[?(@.attribute == 'manager')] `
-Description null -Description Triggered when an identity's manager attribute changes `
-AttributeToFilter LifecycleState `
-FormDefinitionId Admin_Access_Request_Form
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'FormDefinitionInput', 'BetaFormDefini
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | Unique identifier for the form input. | [optional] **Id** | **String** | Unique identifier for the form input. | [optional]
**Type** | **Enum** [ "STRING" ] | FormDefinitionInputType value. STRING FormDefinitionInputTypeString | [optional] **Type** | **Enum** [ "STRING", "ARRAY" ] | FormDefinitionInputType value. STRING FormDefinitionInputTypeString | [optional]
**Label** | **String** | Name for the form input. | [optional] **Label** | **String** | Name for the form input. | [optional]
**Description** | **String** | Form input's description. | [optional] **Description** | **String** | Form input's description. | [optional]

View File

@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityAttributesChanged', 'BetaIden
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Identity** | [**IdentityAttributesChangedIdentity**](identity-attributes-changed-identity) | | [required] **Identity** | [**IdentityAttributesChangedIdentity**](identity-attributes-changed-identity) | | [required]
**Changes** | [**[]IdentityAttributesChangedChangesInner**](identity-attributes-changed-changes-inner) | A list of one or more identity attributes that changed on the identity. | [required] **Changes** | [**[]IdentityAttributesChangedChangesInner**](identity-attributes-changed-changes-inner) | List of identity's attributes that changed. | [required]
## Examples ## Examples

View File

@@ -16,7 +16,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityAttributesChangedChangesInner
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Attribute** | **String** | The name of the identity attribute that changed. | [required] **Attribute** | **String** | Identity attribute's name. | [required]
**OldValue** | [**IdentityAttributesChangedChangesInnerOldValue**](identity-attributes-changed-changes-inner-old-value) | | [optional] **OldValue** | [**IdentityAttributesChangedChangesInnerOldValue**](identity-attributes-changed-changes-inner-old-value) | | [optional]
**NewValue** | [**IdentityAttributesChangedChangesInnerNewValue**](identity-attributes-changed-changes-inner-new-value) | | [optional] **NewValue** | [**IdentityAttributesChangedChangesInnerNewValue**](identity-attributes-changed-changes-inner-new-value) | | [optional]

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity whose attributes changed. | [required] **Type** | **Enum** [ "IDENTITY" ] | DTO type of identity whose attributes changed. | [required]
**Id** | **String** | ID of identity whose attributes changed. | [required] **Id** | **String** | ID of identity whose attributes changed. | [required]
**Name** | **String** | Display name of identity whose attributes changed. | [required] **Name** | **String** | Name of identity whose attributes changed. | [required]
## Examples ## Examples

View File

@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityCreated', 'BetaIdentityCreate
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Identity** | [**IdentityCreatedIdentity**](identity-created-identity) | | [required] **Identity** | [**IdentityCreatedIdentity**](identity-created-identity) | | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | The attributes assigned to the identity. Attributes are determined by the identity profile. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Attributes assigned to the identity. These attributes are determined by the identity profile. | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'IdentityCreatedIdentity', 'BetaIdenti
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | Created identity's DTO type. | [required] **Type** | **Enum** [ "IDENTITY" ] | Identity's DTO type. | [required]
**Id** | **String** | Created identity ID. | [required] **Id** | **String** | Identity's unique ID. | [required]
**Name** | **String** | Created identity's display name. | [required] **Name** | **String** | Identity's name. | [required]
## Examples ## Examples

View File

@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityDeleted', 'BetaIdentityDelete
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Identity** | [**IdentityDeletedIdentity**](identity-deleted-identity) | | [required] **Identity** | [**IdentityDeletedIdentity**](identity-deleted-identity) | | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | The attributes assigned to the identity. Attributes are determined by the identity profile. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Identity attributes. The attributes are determined by the identity profile. | [required]
## Examples ## Examples

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | Deleted identity's DTO type. | [required] **Type** | **Enum** [ "IDENTITY" ] | Deleted identity's DTO type. | [required]
**Id** | **String** | Deleted identity ID. | [required] **Id** | **String** | Deleted identity ID. | [required]
**Name** | **String** | Deleted identity's display name. | [required] **Name** | **String** | Deleted identity's name. | [required]
## Examples ## Examples

View File

@@ -35,6 +35,8 @@ Name | Type | Description | Notes
**RemoveDateUpdateRequested** | **Boolean** | If true, then the request is to change the remove date or sunset date. | [optional] [default to $false] **RemoveDateUpdateRequested** | **Boolean** | If true, then the request is to change the remove date or sunset date. | [optional] [default to $false]
**CurrentRemoveDate** | **System.DateTime** | The remove date or sunset date that was assigned at the time of the request. | [optional] **CurrentRemoveDate** | **System.DateTime** | The remove date or sunset date that was assigned at the time of the request. | [optional]
**SodViolationContext** | [**SodViolationContextCheckCompleted1**](sod-violation-context-check-completed1) | | [optional] **SodViolationContext** | [**SodViolationContextCheckCompleted1**](sod-violation-context-check-completed1) | | [optional]
**ClientMetadata** | **map[string]String** | Arbitrary key-value pairs, if any were included in the corresponding access request item | [optional]
**RequestedAccounts** | [**[]RequestedAccountRef**](requested-account-ref) | The accounts selected by the user for the access to be provisioned on, in case they have multiple accounts on one or more sources. | [optional]
## Examples ## Examples
@@ -58,7 +60,9 @@ $PendingApproval = Initialize-PSSailpoint.BetaPendingApproval -Id 2c9180835d2e5
-RemoveDate 2020-07-11T00:00Z ` -RemoveDate 2020-07-11T00:00Z `
-RemoveDateUpdateRequested true ` -RemoveDateUpdateRequested true `
-CurrentRemoveDate 2020-07-11T00:00Z ` -CurrentRemoveDate 2020-07-11T00:00Z `
-SodViolationContext null -SodViolationContext null `
-ClientMetadata {customKey1=custom value 1, customKey2=custom value 2} `
-RequestedAccounts null
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompleted', 'BetaProvisio
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**TrackingNumber** | **String** | The reference number of the provisioning request. Useful for tracking status in the Account Activity search interface. | [required] **TrackingNumber** | **String** | Provisioning request's reference number. Useful for tracking status in the 'Account Activity' search interface. | [required]
**Sources** | **String** | One or more sources that the provisioning transaction(s) were done against. Sources are comma separated. | [required] **Sources** | **String** | Sources the provisioning transactions were performed on. Sources are comma separated. | [required]
**Action** | **String** | Origin of where the provisioning request came from. | [optional] **Action** | **String** | Origin of the provisioning request. | [optional]
**Errors** | **[]String** | A list of any accumulated error messages that occurred during provisioning. | [optional] **Errors** | **[]String** | List of any accumulated error messages that occurred during provisioning. | [optional]
**Warnings** | **[]String** | A list of any accumulated warning messages that occurred during provisioning. | [optional] **Warnings** | **[]String** | List of any accumulated warning messages that occurred during provisioning. | [optional]
**Recipient** | [**ProvisioningCompletedRecipient**](provisioning-completed-recipient) | | [required] **Recipient** | [**ProvisioningCompletedRecipient**](provisioning-completed-recipient) | | [required]
**Requester** | [**ProvisioningCompletedRequester**](provisioning-completed-requester) | | [optional] **Requester** | [**ProvisioningCompletedRequester**](provisioning-completed-requester) | | [optional]
**AccountRequests** | [**[]ProvisioningCompletedAccountRequestsInner**](provisioning-completed-account-requests-inner) | A list of provisioning instructions to perform on an account-by-account basis. | [required] **AccountRequests** | [**[]ProvisioningCompletedAccountRequestsInner**](provisioning-completed-account-requests-inner) | List of provisioning instructions to perform on an account-by-account basis. | [required]
## Examples ## Examples

View File

@@ -17,19 +17,19 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompletedAccountRequestsI
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Source** | [**ProvisioningCompletedAccountRequestsInnerSource**](provisioning-completed-account-requests-inner-source) | | [required] **Source** | [**ProvisioningCompletedAccountRequestsInnerSource**](provisioning-completed-account-requests-inner-source) | | [required]
**AccountId** | **String** | The unique idenfier of the account being provisioned. | [optional] **AccountId** | **String** | Unique idenfier of the account being provisioned. | [optional]
**AccountOperation** | **String** | The provisioning operation; typically Create, Modify, Enable, Disable, Unlock, or Delete. | [required] **AccountOperation** | **Enum** [ "Create", "Modify", "Enable", "Disable", "Unlock", "Delete" ] | Provisioning operation. | [required]
**ProvisioningResult** | **Enum** [ "SUCCESS", "PENDING", "FAILED" ] | The overall result of the provisioning transaction; this could be success, pending, failed, etc. | [required] **ProvisioningResult** | **Enum** [ "SUCCESS", "PENDING", "FAILED" ] | Overall result of the provisioning transaction. | [required]
**ProvisioningTarget** | **String** | The name of the provisioning channel selected; this could be the same as the source, or could be a Service Desk Integration Module (SDIM). | [required] **ProvisioningTarget** | **String** | Nme of the selected provisioning channel selected. This could be the same as the source, or it could be a Service Desk Integration Module (SDIM). | [required]
**TicketId** | **String** | A reference to a tracking number, if this is sent to a Service Desk Integration Module (SDIM). | [optional] **TicketId** | **String** | Reference to a tracking number for if this is sent to a SDIM. | [optional]
**AttributeRequests** | [**[]ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner**](provisioning-completed-account-requests-inner-attribute-requests-inner) | A list of attributes as part of the provisioning transaction. | [optional] **AttributeRequests** | [**[]ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner**](provisioning-completed-account-requests-inner-attribute-requests-inner) | List of attributes to include in the provisioning transaction. | [optional]
## Examples ## Examples
- Prepare the resource - Prepare the resource
```powershell ```powershell
$ProvisioningCompletedAccountRequestsInner = Initialize-PSSailpoint.BetaProvisioningCompletedAccountRequestsInner -Source null ` $ProvisioningCompletedAccountRequestsInner = Initialize-PSSailpoint.BetaProvisioningCompletedAccountRequestsInner -Source null `
-AccountId CN=Chewy.Bacca,ou=hardcorefigter,ou=wookies,dc=starwars,dc=com ` -AccountId CN=Rob.Robertson,ou=csm,ou=sales,dc=helpco,dc=com `
-AccountOperation Modify ` -AccountOperation Modify `
-ProvisioningResult SUCCESS ` -ProvisioningResult SUCCESS `
-ProvisioningTarget Corp AD ` -ProvisioningTarget Corp AD `

View File

@@ -16,8 +16,8 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompletedAccountRequestsI
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**AttributeName** | **String** | The name of the attribute being provisioned. | [required] **AttributeName** | **String** | Name of the attribute being provisioned. | [required]
**AttributeValue** | **String** | The value of the attribute being provisioned. | [optional] **AttributeValue** | **String** | Value of the attribute being provisioned. | [optional]
**Operation** | **Enum** [ "Add", "Set", "Remove" ] | The operation to handle the attribute. | [required] **Operation** | **Enum** [ "Add", "Set", "Remove" ] | The operation to handle the attribute. | [required]
## Examples ## Examples
@@ -25,7 +25,7 @@ Name | Type | Description | Notes
- Prepare the resource - Prepare the resource
```powershell ```powershell
$ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner = Initialize-PSSailpoint.BetaProvisioningCompletedAccountRequestsInnerAttributeRequestsInner -AttributeName memberOf ` $ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner = Initialize-PSSailpoint.BetaProvisioningCompletedAccountRequestsInnerAttributeRequestsInner -AttributeName memberOf `
-AttributeValue CN=jedi,DC=starwars,DC=com ` -AttributeValue CN=sales,DC=helpco,DC=com `
-Operation Add -Operation Add
``` ```

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompletedAccountRequestsI
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | ID of the object to which this reference applies | [required] **Id** | **String** | Source ID. | [required]
**Type** | **Enum** [ "SOURCE" ] | The type of object that is referenced | [required] **Type** | **Enum** [ "SOURCE" ] | Source DTO type. | [required]
**Name** | **String** | Human-readable display name of the object to which this reference applies | [required] **Name** | **String** | Source name. | [required]
## Examples ## Examples

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | Provisioning recipient DTO type. | [required] **Type** | **Enum** [ "IDENTITY" ] | Provisioning recipient DTO type. | [required]
**Id** | **String** | Provisioning recipient's identity ID. | [required] **Id** | **String** | Provisioning recipient's identity ID. | [required]
**Name** | **String** | Provisioning recipient's display name. | [required] **Name** | **String** | Provisioning recipient's name. | [required]
## Examples ## Examples

View File

@@ -18,7 +18,7 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | Provisioning requester's DTO type. | [required] **Type** | **Enum** [ "IDENTITY" ] | Provisioning requester's DTO type. | [required]
**Id** | **String** | Provisioning requester's identity ID. | [required] **Id** | **String** | Provisioning requester's identity ID. | [required]
**Name** | **String** | Provisioning owner's human-readable display name. | [required] **Name** | **String** | Provisioning requester's name. | [required]
## Examples ## Examples

View File

@@ -0,0 +1,43 @@
---
id: beta-requested-account-ref
title: RequestedAccountRef
pagination_label: RequestedAccountRef
sidebar_label: RequestedAccountRef
sidebar_class_name: powershellsdk
keywords: ['powershell', 'PowerShell', 'sdk', 'RequestedAccountRef', 'BetaRequestedAccountRef']
slug: /tools/sdk/powershell/beta/models/requested-account-ref
tags: ['SDK', 'Software Development Kit', 'RequestedAccountRef', 'BetaRequestedAccountRef']
---
# RequestedAccountRef
## Properties
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**Name** | **String** | Display name of the account for the user | [optional]
**Type** | [**DtoType**](dto-type) | | [optional]
**AccountUuid** | **String** | The uuid for the account | [optional]
**AccountId** | **String** | The native identity for the account | [optional]
**SourceName** | **String** | Display name of the source for the account | [optional]
## Examples
- Prepare the resource
```powershell
$RequestedAccountRef = Initialize-PSSailpoint.BetaRequestedAccountRef -Name Glen.067da3248e914 `
-Type null `
-AccountUuid {fab7119e-004f-4822-9c33-b8d570d6c6a6} `
-AccountId CN=Glen 067da3248e914,OU=YOUROU,OU=org-data-service,DC=YOURDC,DC=local `
-SourceName Multi Account AD source name
```
- Convert the resource to JSON
```powershell
$RequestedAccountRef | ConvertTo-JSON
```
[[Back to top]](#)

View File

@@ -41,6 +41,7 @@ Name | Type | Description | Notes
**Cancelable** | **Boolean** | True if the request can be canceled. | [optional] [default to $false] **Cancelable** | **Boolean** | True if the request can be canceled. | [optional] [default to $false]
**AccessRequestId** | **String** | This is the account activity id. | [optional] **AccessRequestId** | **String** | This is the account activity id. | [optional]
**ClientMetadata** | **map[string]String** | Arbitrary key-value pairs, if any were included in the corresponding access request | [optional] **ClientMetadata** | **map[string]String** | Arbitrary key-value pairs, if any were included in the corresponding access request | [optional]
**RequestedAccounts** | [**[]RequestedAccountRef**](requested-account-ref) | The accounts selected by the user for the access to be provisioned on, in case they have multiple accounts on one or more sources. | [optional]
## Examples ## Examples
@@ -70,7 +71,8 @@ $RequestedItemStatus = Initialize-PSSailpoint.BetaRequestedItemStatus -Id 2c918
-RemoveDate 2019-10-23T00:00Z ` -RemoveDate 2019-10-23T00:00Z `
-Cancelable true ` -Cancelable true `
-AccessRequestId 2b838de9-db9b-abcf-e646-d4f274ad4238 ` -AccessRequestId 2b838de9-db9b-abcf-e646-d4f274ad4238 `
-ClientMetadata {key1=value1, key2=value2} -ClientMetadata {key1=value1, key2=value2} `
-RequestedAccounts null
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'Reviewer', 'BetaReviewer']
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY", "GOVERNANCE_GROUP" ] | The reviewer's DTO type. | [required] **Type** | **Enum** [ "IDENTITY", "GOVERNANCE_GROUP" ] | Reviewer's DTO type. | [required]
**Id** | **String** | The reviewer's ID. | [required] **Id** | **String** | Reviewer's ID. | [required]
**Name** | **String** | The reviewer's display name. | [required] **Name** | **String** | Reviewer's display name. | [required]
**Email** | **String** | The reviewing identity's email. Only applicable to `IDENTITY`. | [optional] **Email** | **String** | Reviewing identity's email. This is only applicable to reviewers of the `IDENTITY` type. | [optional]
## Examples ## Examples

View File

@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchComplete', 'BetaSavedSearc
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**FileName** | **String** | A name for the report file. | [required] **FileName** | **String** | Report file name. | [required]
**OwnerEmail** | **String** | The email address of the identity that owns the saved search. | [required] **OwnerEmail** | **String** | Email address of the identity who owns the saved search. | [required]
**OwnerName** | **String** | The name of the identity that owns the saved search. | [required] **OwnerName** | **String** | Name of the identity who owns the saved search. | [required]
**Query** | **String** | The search query that was used to generate the report. | [required] **Query** | **String** | Search query used to generate the report. | [required]
**SearchName** | **String** | The name of the saved search. | [required] **SearchName** | **String** | Saved search name. | [required]
**SearchResults** | [**SavedSearchCompleteSearchResults**](saved-search-complete-search-results) | | [required] **SearchResults** | [**SavedSearchCompleteSearchResults**](saved-search-complete-search-results) | | [required]
**SignedS3Url** | **String** | The Amazon S3 URL to download the report from. | [required] **SignedS3Url** | **String** | The Amazon S3 URL to download the report from. | [required]

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchCompleteSearchResultsAccou
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Count** | **String** | The number of rows in the table. | [required] **Count** | **String** | Number of rows in the table. | [required]
**Noun** | **String** | The type of object represented in the table. | [required] **Noun** | **String** | Type of object represented in the table. | [required]
**Preview** | **[]String[]** | A sample of the data in the table. | [required] **Preview** | **[]String[]** | Sample of table data. | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchCompleteSearchResultsEntit
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Count** | **String** | The number of rows in the table. | [required] **Count** | **String** | Number of rows in the table. | [required]
**Noun** | **String** | The type of object represented in the table. | [required] **Noun** | **String** | Type of object represented in the table. | [required]
**Preview** | **[]String[]** | A sample of the data in the table. | [required] **Preview** | **[]String[]** | Sample of table data. | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchCompleteSearchResultsIdent
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Count** | **String** | The number of rows in the table. | [required] **Count** | **String** | Number of rows in the table. | [required]
**Noun** | **String** | The type of object represented in the table. | [required] **Noun** | **String** | Type of object represented in the table. | [required]
**Preview** | **[]String[]** | A sample of the data in the table. | [required] **Preview** | **[]String[]** | Sample of the table data. | [required]
## Examples ## Examples

View File

@@ -18,19 +18,21 @@ Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Frequency** | **Enum** [ "daily", "weekly", "monthly", "yearly", "cronSchedule" ] | Frequency of execution | [required] **Frequency** | **Enum** [ "daily", "weekly", "monthly", "yearly", "cronSchedule" ] | Frequency of execution | [required]
**TimeZone** | **String** | Time zone identifier | [optional] **TimeZone** | **String** | Time zone identifier | [optional]
**CronString** | **String** | | [optional] **CronString** | **String** | A valid CRON expression | [optional]
**WeeklyDays** | **[]String** | Scheduled days of the week for execution | [optional] **WeeklyDays** | **[]String** | Scheduled days of the week for execution | [optional]
**WeeklyTimes** | **[]String** | Scheduled execution times | [optional] **WeeklyTimes** | **[]String** | Scheduled execution times | [optional]
**YearlyTimes** | **[]String** | Scheduled execution times | [optional]
## Examples ## Examples
- Prepare the resource - Prepare the resource
```powershell ```powershell
$ScheduledAttributes = Initialize-PSSailpoint.BetaScheduledAttributes -Frequency null ` $ScheduledAttributes = Initialize-PSSailpoint.BetaScheduledAttributes -Frequency daily `
-TimeZone America/Chicago ` -TimeZone America/Chicago `
-CronString 0 9 * * 1 ` -CronString 0 9 * * 1 `
-WeeklyDays Monday ` -WeeklyDays Monday `
-WeeklyTimes Monday -WeeklyTimes Monday `
-YearlyTimes 1969-12-31T09:00:00.000Z
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'SourceAccountCreated', 'BetaSourceAcc
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Uuid** | **String** | Source unique identifier for the identity. UUID is generated by the source system. | [optional] **Uuid** | **String** | Identity's universal unique identifier (UUID) on the source. The source system generates the UUID. | [required]
**Id** | **String** | SailPoint generated unique identifier. | [required] **Id** | **String** | SailPoint generated unique identifier. | [required]
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required] **NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
**SourceId** | **String** | The ID of the source. | [required] **SourceId** | **String** | Source ID. | [required]
**SourceName** | **String** | The name of the source. | [required] **SourceName** | **String** | Source name. | [required]
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required] **IdentityId** | **String** | ID of the identity correlated with the account. | [required]
**IdentityName** | **String** | The name of the identity that is correlated with this account. | [required] **IdentityName** | **String** | Name of the identity correlated with the account. | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | The attributes of the account. The contents of attributes depends on the account schema for the source. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
## Examples ## Examples

View File

@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'SourceAccountDeleted', 'BetaSourceAcc
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Uuid** | **String** | Source unique identifier for the identity. UUID is generated by the source system. | [optional] **Uuid** | **String** | Identity's universal unique identifier (UUID) on the source. The source system generates the UUID. | [required]
**Id** | **String** | SailPoint generated unique identifier. | [required] **Id** | **String** | SailPoint generated unique identifier. | [required]
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required] **NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
**SourceId** | **String** | The ID of the source. | [required] **SourceId** | **String** | Source ID. | [required]
**SourceName** | **String** | The name of the source. | [required] **SourceName** | **String** | Source name. | [required]
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required] **IdentityId** | **String** | ID of the identity correlated with the account. | [required]
**IdentityName** | **String** | The name of the identity that is correlated with this account. | [required] **IdentityName** | **String** | Name of the identity correlated with the account. | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | The attributes of the account. The contents of attributes depends on the account schema for the source. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
## Examples ## Examples

View File

@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'SourceAccountUpdated', 'BetaSourceAcc
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Uuid** | **String** | Source unique identifier for the identity. UUID is generated by the source system. | [optional] **Uuid** | **String** | Identity's universal unique identifier (UUID) on the source. The source system generates the UUID. | [required]
**Id** | **String** | SailPoint generated unique identifier. | [required] **Id** | **String** | SailPoint generated unique identifier. | [required]
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required] **NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
**SourceId** | **String** | The ID of the source. | [required] **SourceId** | **String** | Source ID. | [required]
**SourceName** | **String** | The name of the source. | [required] **SourceName** | **String** | Source name. | [required]
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required] **IdentityId** | **String** | ID of the identity correlated with the account. | [required]
**IdentityName** | **String** | The name of the identity that is correlated with this account. | [required] **IdentityName** | **String** | Name of the identity correlated with the account. | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | The attributes of the account. The contents of attributes depends on the account schema for the source. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
## Examples ## Examples

View File

@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SourceCreated', 'BetaSourceCreated']
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the source. | [required] **Id** | **String** | Source's unique ID. | [required]
**Name** | **String** | Human friendly name of the source. | [required] **Name** | **String** | Source name. | [required]
**Type** | **String** | The connection type. | [required] **Type** | **String** | Connection type. | [required]
**Created** | **System.DateTime** | The date and time the source was created. | [required] **Created** | **System.DateTime** | Date and time when the source was created. | [required]
**Connector** | **String** | The connector type used to connect to the source. | [required] **Connector** | **String** | Connector type used to connect to the source. | [required]
**Actor** | [**SourceCreatedActor**](source-created-actor) | | [required] **Actor** | [**SourceCreatedActor**](source-created-actor) | | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SourceCreatedActor', 'BetaSourceCreat
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who created the source. | [required] **Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who created the source. | [required]
**Id** | **String** | ID of identity who created the source. | [required] **Id** | **String** | ID of the identity who created the source. | [required]
**Name** | **String** | Display name of identity who created the source. | [required] **Name** | **String** | Name of the identity who created the source. | [required]
## Examples ## Examples

View File

@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SourceDeleted', 'BetaSourceDeleted']
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the source. | [required] **Id** | **String** | Source's unique ID. | [required]
**Name** | **String** | Human friendly name of the source. | [required] **Name** | **String** | Source name. | [required]
**Type** | **String** | The connection type. | [required] **Type** | **String** | Connection type. | [required]
**Deleted** | **System.DateTime** | The date and time the source was deleted. | [required] **Deleted** | **System.DateTime** | Date and time when the source was deleted. | [required]
**Connector** | **String** | The connector type used to connect to the source. | [required] **Connector** | **String** | Connector type used to connect to the source. | [required]
**Actor** | [**SourceDeletedActor**](source-deleted-actor) | | [required] **Actor** | [**SourceDeletedActor**](source-deleted-actor) | | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SourceDeletedActor', 'BetaSourceDelet
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who deleted the source. | [required] **Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who deleted the source. | [required]
**Id** | **String** | ID of identity who deleted the source. | [required] **Id** | **String** | ID of the identity who deleted the source. | [required]
**Name** | **String** | Display name of identity who deleted the source. | [required] **Name** | **String** | Name of the identity who deleted the source. | [required]
## Examples ## Examples

View File

@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SourceUpdated', 'BetaSourceUpdated']
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The unique ID of the source. | [required] **Id** | **String** | Source's unique ID. | [required]
**Name** | **String** | The user friendly name of the source. | [required] **Name** | **String** | Source name. | [required]
**Type** | **String** | The connection type of the source. | [required] **Type** | **String** | Connection type. | [required]
**Modified** | **System.DateTime** | The date and time the source was modified. | [required] **Modified** | **System.DateTime** | Date and time when the source was modified. | [required]
**Connector** | **String** | The connector type used to connect to the source. | [required] **Connector** | **String** | Connector type used to connect to the source. | [required]
**Actor** | [**SourceUpdatedActor**](source-updated-actor) | | [required] **Actor** | [**SourceUpdatedActor**](source-updated-actor) | | [required]
## Examples ## Examples
@@ -28,7 +28,7 @@ Name | Type | Description | Notes
- Prepare the resource - Prepare the resource
```powershell ```powershell
$SourceUpdated = Initialize-PSSailpoint.BetaSourceUpdated -Id 2c9180866166b5b0016167c32ef31a66 ` $SourceUpdated = Initialize-PSSailpoint.BetaSourceUpdated -Id 2c9180866166b5b0016167c32ef31a66 `
-Name Corporate Active Directory ` -Name Test source `
-Type DIRECT_CONNECT ` -Type DIRECT_CONNECT `
-Modified 2021-03-29T22:01:50.474Z ` -Modified 2021-03-29T22:01:50.474Z `
-Connector active-directory ` -Connector active-directory `

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SourceUpdatedActor', 'BetaSourceUpdat
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who updated the source. | [required] **Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who updated the source. | [required]
**Id** | **String** | ID of identity who updated the source. | [optional] **Id** | **String** | ID of the identity who updated the source. | [required]
**Name** | **String** | Display name of identity who updated the source. | [required] **Name** | **String** | Name of the identity who updated the source. | [required]
## Examples ## Examples

View File

@@ -32,7 +32,7 @@ $TaskDefinitionSummary = Initialize-PSSailpoint.BetaTaskDefinitionSummary -Id 2
-Description Aggregates from the specified application. ` -Description Aggregates from the specified application. `
-ParentName Cloud Account Aggregation ` -ParentName Cloud Account Aggregation `
-Executor sailpoint.task.ServiceTaskExecutor ` -Executor sailpoint.task.ServiceTaskExecutor `
-Arguments null -Arguments {mantisExecutor=com.sailpoint.mantis.sources.task.AccountAggregationTask, eventClassesCsv=sailpoint.thunderbolt.events.AggregationEvents, serviceClass=sailpoint.thunderbolt.service.AggregationService, serviceMethod=accountAggregationTask}
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -16,52 +16,52 @@ tags: ['SDK', 'Software Development Kit', 'TriggerExampleInput', 'BetaTriggerExa
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**AccessRequestId** | **String** | The unique ID of the access request. | [required] **AccessRequestId** | **String** | Access request's unique ID. | [required]
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required] **RequestedFor** | [**[]AccessItemRequestedForDto1**](access-item-requested-for-dto1) | Identities whom access was requested for. | [required]
**RequestedItems** | [**[]AccessRequestPreApprovalRequestedItemsInner**](access-request-pre-approval-requested-items-inner) | Details of the access items being requested. | [required] **RequestedItems** | [**[]AccessRequestPreApprovalRequestedItemsInner**](access-request-pre-approval-requested-items-inner) | Details about each requested access item. | [required]
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required] **RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
**RequestedItemsStatus** | [**[]AccessRequestPostApprovalRequestedItemsStatusInner**](access-request-post-approval-requested-items-status-inner) | Details on the outcome of each access item. | [required] **RequestedItemsStatus** | [**[]AccessRequestPostApprovalRequestedItemsStatusInner**](access-request-post-approval-requested-items-status-inner) | Details about the outcome of each requested access item. | [required]
**Source** | [**AccountUncorrelatedSource**](account-uncorrelated-source) | | [required] **Source** | [**AccountUncorrelatedSource**](account-uncorrelated-source) | | [required]
**Status** | **Enum** [ "Success", "Failed", "Terminated" ] | The overall status of the collection. | [required] **Status** | **Enum** [ "Success", "Failed", "Terminated" ] | The overall status of the collection. | [required]
**Started** | **System.DateTime** | The date and time when the account collection started. | [required] **Started** | **System.DateTime** | The date and time when the account collection started. | [required]
**Completed** | **System.DateTime** | The date and time when the account collection finished. | [required] **Completed** | **System.DateTime** | The date and time when the account collection finished. | [required]
**Errors** | **[]String** | A list of any accumulated error messages that occurred during provisioning. | [required] **Errors** | **[]String** | List of any accumulated error messages that occurred during provisioning. | [required]
**Warnings** | **[]String** | A list of any accumulated warning messages that occurred during provisioning. | [required] **Warnings** | **[]String** | List of any accumulated warning messages that occurred during provisioning. | [required]
**Stats** | [**AccountsCollectedForAggregationStats**](accounts-collected-for-aggregation-stats) | | [required] **Stats** | [**AccountsCollectedForAggregationStats**](accounts-collected-for-aggregation-stats) | | [required]
**Identity** | [**IdentityDeletedIdentity**](identity-deleted-identity) | | [required] **Identity** | [**IdentityDeletedIdentity**](identity-deleted-identity) | | [required]
**Account** | [**AccountUncorrelatedAccount**](account-uncorrelated-account) | | [required] **Account** | [**AccountUncorrelatedAccount**](account-uncorrelated-account) | | [required]
**Changes** | [**[]IdentityAttributesChangedChangesInner**](identity-attributes-changed-changes-inner) | A list of one or more identity attributes that changed on the identity. | [required] **Changes** | [**[]IdentityAttributesChangedChangesInner**](identity-attributes-changed-changes-inner) | List of identity's attributes that changed. | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | The attributes of the account. The contents of attributes depends on the account schema for the source. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
**EntitlementCount** | **Int32** | The number of entitlements associated with this account. | [optional] **EntitlementCount** | **Int32** | The number of entitlements associated with this account. | [optional]
**Campaign** | [**CampaignGeneratedCampaign**](campaign-generated-campaign) | | [required] **Campaign** | [**CampaignGeneratedCampaign**](campaign-generated-campaign) | | [required]
**Certification** | [**CertificationSignedOffCertification**](certification-signed-off-certification) | | [required] **Certification** | [**CertificationSignedOffCertification**](certification-signed-off-certification) | | [required]
**TrackingNumber** | **String** | The reference number of the provisioning request. Useful for tracking status in the Account Activity search interface. | [required] **TrackingNumber** | **String** | Provisioning request's reference number. Useful for tracking status in the 'Account Activity' search interface. | [required]
**Sources** | **String** | One or more sources that the provisioning transaction(s) were done against. Sources are comma separated. | [required] **Sources** | **String** | Sources the provisioning transactions were performed on. Sources are comma separated. | [required]
**Action** | **String** | Origin of where the provisioning request came from. | [optional] **Action** | **String** | Origin of the provisioning request. | [optional]
**Recipient** | [**ProvisioningCompletedRecipient**](provisioning-completed-recipient) | | [required] **Recipient** | [**ProvisioningCompletedRecipient**](provisioning-completed-recipient) | | [required]
**Requester** | [**ProvisioningCompletedRequester**](provisioning-completed-requester) | | [optional] **Requester** | [**ProvisioningCompletedRequester**](provisioning-completed-requester) | | [optional]
**AccountRequests** | [**[]ProvisioningCompletedAccountRequestsInner**](provisioning-completed-account-requests-inner) | A list of provisioning instructions to perform on an account-by-account basis. | [required] **AccountRequests** | [**[]ProvisioningCompletedAccountRequestsInner**](provisioning-completed-account-requests-inner) | List of provisioning instructions to perform on an account-by-account basis. | [required]
**FileName** | **String** | A name for the report file. | [required] **FileName** | **String** | Report file name. | [required]
**OwnerEmail** | **String** | The email address of the identity that owns the saved search. | [required] **OwnerEmail** | **String** | Email address of the identity who owns the saved search. | [required]
**OwnerName** | **String** | The name of the identity that owns the saved search. | [required] **OwnerName** | **String** | Name of the identity who owns the saved search. | [required]
**Query** | **String** | The search query that was used to generate the report. | [required] **Query** | **String** | Search query used to generate the report. | [required]
**SearchName** | **String** | The name of the saved search. | [required] **SearchName** | **String** | Saved search name. | [required]
**SearchResults** | [**SavedSearchCompleteSearchResults**](saved-search-complete-search-results) | | [required] **SearchResults** | [**SavedSearchCompleteSearchResults**](saved-search-complete-search-results) | | [required]
**SignedS3Url** | **String** | The Amazon S3 URL to download the report from. | [required] **SignedS3Url** | **String** | The Amazon S3 URL to download the report from. | [required]
**Uuid** | **String** | Source unique identifier for the identity. UUID is generated by the source system. | [optional] **Uuid** | **String** | Identity's universal unique identifier (UUID) on the source. The source system generates the UUID. | [required]
**Id** | **String** | The unique ID of the source. | [required] **Id** | **String** | Source's unique ID. | [required]
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required] **NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
**SourceId** | **String** | The ID of the source. | [required] **SourceId** | **String** | Source ID. | [required]
**SourceName** | **String** | The name of the source. | [required] **SourceName** | **String** | Source name. | [required]
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required] **IdentityId** | **String** | ID of the identity correlated with the account. | [required]
**IdentityName** | **String** | The name of the identity that is correlated with this account. | [required] **IdentityName** | **String** | Name of the identity correlated with the account. | [required]
**Name** | **String** | The user friendly name of the source. | [required] **Name** | **String** | Source name. | [required]
**Type** | **String** | The connection type of the source. | [required] **Type** | **String** | Connection type. | [required]
**Created** | **System.DateTime** | The date and time the status change occurred. | [required] **Created** | **System.DateTime** | Date and time when the status change occurred. | [required]
**Connector** | **String** | The connector type used to connect to the source. | [required] **Connector** | **String** | Connector type used to connect to the source. | [required]
**Actor** | [**SourceUpdatedActor**](source-updated-actor) | | [required] **Actor** | [**SourceUpdatedActor**](source-updated-actor) | | [required]
**Deleted** | **System.DateTime** | The date and time the source was deleted. | [required] **Deleted** | **System.DateTime** | Date and time when the source was deleted. | [required]
**Modified** | **System.DateTime** | The date and time the source was modified. | [required] **Modified** | **System.DateTime** | Date and time when the source was modified. | [required]
**Application** | [**VAClusterStatusChangeEventApplication**](va-cluster-status-change-event-application) | | [required] **Application** | [**VAClusterStatusChangeEventApplication**](va-cluster-status-change-event-application) | | [required]
**HealthCheckResult** | [**VAClusterStatusChangeEventHealthCheckResult**](va-cluster-status-change-event-health-check-result) | | [required] **HealthCheckResult** | [**VAClusterStatusChangeEventHealthCheckResult**](va-cluster-status-change-event-health-check-result) | | [required]
**PreviousHealthCheckResult** | [**VAClusterStatusChangeEventPreviousHealthCheckResult**](va-cluster-status-change-event-previous-health-check-result) | | [required] **PreviousHealthCheckResult** | [**VAClusterStatusChangeEventPreviousHealthCheckResult**](va-cluster-status-change-event-previous-health-check-result) | | [required]
@@ -109,7 +109,7 @@ $TriggerExampleInput = Initialize-PSSailpoint.BetaTriggerExampleInput -AccessRe
-SourceName Active Directory ` -SourceName Active Directory `
-IdentityId ee769173319b41d19ccec6c235423237b ` -IdentityId ee769173319b41d19ccec6c235423237b `
-IdentityName john.doe ` -IdentityName john.doe `
-Name Corporate Active Directory ` -Name Test source `
-Type DIRECT_CONNECT ` -Type DIRECT_CONNECT `
-Created 2020-06-29T22:01:50.474Z ` -Created 2020-06-29T22:01:50.474Z `
-Connector active-directory ` -Connector active-directory `

View File

@@ -16,8 +16,8 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEvent', 'BetaVAC
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Created** | **System.DateTime** | The date and time the status change occurred. | [required] **Created** | **System.DateTime** | Date and time when the status change occurred. | [required]
**Type** | **Enum** [ "SOURCE", "CLUSTER" ] | The type of the object that initiated this event. | [required] **Type** | **Enum** [ "SOURCE", "CLUSTER" ] | Type of the object that initiated the event. | [required]
**Application** | [**VAClusterStatusChangeEventApplication**](va-cluster-status-change-event-application) | | [required] **Application** | [**VAClusterStatusChangeEventApplication**](va-cluster-status-change-event-application) | | [required]
**HealthCheckResult** | [**VAClusterStatusChangeEventHealthCheckResult**](va-cluster-status-change-event-health-check-result) | | [required] **HealthCheckResult** | [**VAClusterStatusChangeEventHealthCheckResult**](va-cluster-status-change-event-health-check-result) | | [required]
**PreviousHealthCheckResult** | [**VAClusterStatusChangeEventPreviousHealthCheckResult**](va-cluster-status-change-event-previous-health-check-result) | | [required] **PreviousHealthCheckResult** | [**VAClusterStatusChangeEventPreviousHealthCheckResult**](va-cluster-status-change-event-previous-health-check-result) | | [required]

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEventApplication
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Id** | **String** | The GUID of the application | [required] **Id** | **String** | Application's globally unique identifier (GUID). | [required]
**Name** | **String** | The name of the application | [required] **Name** | **String** | Application name. | [required]
**Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Custom map of attributes for a source. This will only be populated if type is `SOURCE` and the source has a proxy. | [required] **Attributes** | [**map[string]AnyType**]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4 | Custom map of attributes for a source. Attributes only populate if the type is `SOURCE` and the source has a proxy. | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEventHealthCheck
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Message** | **String** | Detailed message of the result of the health check. | [required] **Message** | **String** | Detailed message of the health check result.. | [required]
**ResultType** | **String** | The type of the health check result. | [required] **ResultType** | **String** | Health check result type. | [required]
**Status** | **Enum** [ "Succeeded", "Failed" ] | The status of the health check. | [required] **Status** | **Enum** [ "Succeeded", "Failed" ] | Health check status. | [required]
## Examples ## Examples

View File

@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEventPreviousHea
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
**Message** | **String** | Detailed message of the result of the health check. | [required] **Message** | **String** | Detailed message of the health check result. | [required]
**ResultType** | **String** | The type of the health check result. | [required] **ResultType** | **String** | Health check result type. | [required]
**Status** | **Enum** [ "Succeeded", "Failed" ] | The status of the health check. | [required] **Status** | **Enum** [ "Succeeded", "Failed" ] | Health check status. | [required]
## Examples ## Examples

View File

@@ -19,14 +19,17 @@ Name | Type | Description | Notes
**Id** | **String** | The unique ID of the trigger | [required] **Id** | **String** | The unique ID of the trigger | [required]
**VarFilter** | **String** | JSON path expression that will limit which events the trigger will fire on | [optional] **VarFilter** | **String** | JSON path expression that will limit which events the trigger will fire on | [optional]
**Description** | **String** | Additional context about the external trigger | [optional] **Description** | **String** | Additional context about the external trigger | [optional]
**AttributeToFilter** | **String** | The attribute to filter on | [optional]
**FormDefinitionId** | **String** | Form definition's unique identifier. | [optional]
**Name** | **String** | A unique name for the external trigger | [optional] **Name** | **String** | A unique name for the external trigger | [optional]
**ClientId** | **String** | OAuth Client ID to authenticate with this trigger | [optional] **ClientId** | **String** | OAuth Client ID to authenticate with this trigger | [optional]
**Url** | **String** | URL to invoke this workflow | [optional] **Url** | **String** | URL to invoke this workflow | [optional]
**Frequency** | **Enum** [ "daily", "weekly", "monthly", "yearly", "cronSchedule" ] | Frequency of execution | [required] **Frequency** | **Enum** [ "daily", "weekly", "monthly", "yearly", "cronSchedule" ] | Frequency of execution | [required]
**TimeZone** | **String** | Time zone identifier | [optional] **TimeZone** | **String** | Time zone identifier | [optional]
**CronString** | **String** | | [optional] **CronString** | **String** | A valid CRON expression | [optional]
**WeeklyDays** | **[]String** | Scheduled days of the week for execution | [optional] **WeeklyDays** | **[]String** | Scheduled days of the week for execution | [optional]
**WeeklyTimes** | **[]String** | Scheduled execution times | [optional] **WeeklyTimes** | **[]String** | Scheduled execution times | [optional]
**YearlyTimes** | **[]String** | Scheduled execution times | [optional]
## Examples ## Examples
@@ -35,14 +38,17 @@ Name | Type | Description | Notes
$WorkflowTriggerAttributes = Initialize-PSSailpoint.BetaWorkflowTriggerAttributes -Id idn:identity-attributes-changed ` $WorkflowTriggerAttributes = Initialize-PSSailpoint.BetaWorkflowTriggerAttributes -Id idn:identity-attributes-changed `
-VarFilter $.changes[?(@.attribute == 'manager')] ` -VarFilter $.changes[?(@.attribute == 'manager')] `
-Description Run a search and notify the results ` -Description Run a search and notify the results `
-AttributeToFilter LifecycleState `
-FormDefinitionId Admin_Access_Request_Form `
-Name search-and-notify ` -Name search-and-notify `
-ClientId 87e239b2-b85b-4bde-b9a7-55bf304ddcdc ` -ClientId 87e239b2-b85b-4bde-b9a7-55bf304ddcdc `
-Url https://tenant.api.identitynow.com/beta/workflows/execute/external/c79e0079-562c-4df5-aa73-60a9e25c916d ` -Url https://tenant.api.identitynow.com/beta/workflows/execute/external/c79e0079-562c-4df5-aa73-60a9e25c916d `
-Frequency null ` -Frequency daily `
-TimeZone America/Chicago ` -TimeZone America/Chicago `
-CronString 0 9 * * 1 ` -CronString 0 9 * * 1 `
-WeeklyDays Monday ` -WeeklyDays Monday `
-WeeklyTimes Monday -WeeklyTimes Monday `
-YearlyTimes 1969-12-31T09:00:00.000Z
``` ```
- Convert the resource to JSON - Convert the resource to JSON

View File

@@ -23,7 +23,7 @@ When users only need Active Directory employee access, they can request access t
When users need both Active Directory employee and developer access, they can request access to the &#39;AD Developers&#39; access profile. When users need both Active Directory employee and developer access, they can request access to the &#39;AD Developers&#39; access profile.
Access profiles are the most important units of access in Identity Security Cloud. Identity Security Cloud uses access profiles in many features, including the following: Identity Security Cloud uses access profiles in many features, including the following:
- Provisioning: When you use the Provisioning Service, lifecycle states and roles both grant access to users in the form of access profiles. - Provisioning: When you use the Provisioning Service, lifecycle states and roles both grant access to users in the form of access profiles.
@@ -62,7 +62,7 @@ Method | HTTP request | Description
## create-access-profile ## create-access-profile
Use this API to create an access profile. Create an access profile.
A user with only ROLE_SUBADMIN or SOURCE_SUBADMIN authority must be associated with the access profile's Source. A user with only ROLE_SUBADMIN or SOURCE_SUBADMIN authority must be associated with the access profile's Source.
The maximum supported length for the description field is 2000 characters. Longer descriptions will be preserved for existing access profiles. However, any new access profiles as well as any updates to existing descriptions are limited to 2000 characters. The maximum supported length for the description field is 2000 characters. Longer descriptions will be preserved for existing access profiles. However, any new access profiles as well as any updates to existing descriptions are limited to 2000 characters.
@@ -399,7 +399,7 @@ try {
[[Back to top]](#) [[Back to top]](#)
## list-access-profiles ## list-access-profiles
Use this API to get a list of access profiles. Get a list of access profiles.
>**Note:** When you filter for access profiles that have the '+' symbol in their names, the response is blank. >**Note:** When you filter for access profiles that have the '+' symbol in their names, the response is blank.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/list-access-profiles) [API Spec](https://developer.sailpoint.com/docs/api/v2024/list-access-profiles)
@@ -407,14 +407,14 @@ Use this API to get a list of access profiles.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Query | ForSubadmin | **String** | (optional) | If provided, filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID, or the special value **me**, which is shorthand for the calling identity's ID. A 400 Bad Request error is returned if the **for-subadmin** parameter is specified for an identity that is not a subadmin. Query | ForSubadmin | **String** | (optional) | Filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID or the special value **me**, which is shorthand for the calling identity's ID. If you specify an identity that isn't a subadmin, the API returns a 400 Bad Request error.
Query | Limit | **Int32** | (optional) (default to 50) | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Composite operators supported: *and, or* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names. Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Supported composite operators are *and, or* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names.
Query | Sorters | **String** | (optional) | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified** Query | Sorters | **String** | (optional) | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified**
Query | ForSegmentIds | **String** | (optional) | If present and not empty, additionally filters access profiles to those which are assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error. Query | ForSegmentIds | **String** | (optional) | Filters access profiles to only those assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error.
Query | IncludeUnsegmented | **Boolean** | (optional) (default to $true) | Indicates whether the response list should contain unsegmented access profiles. If *for-segment-ids* is absent or empty, specifying *include-unsegmented* as false results in an error. Query | IncludeUnsegmented | **Boolean** | (optional) (default to $true) | Indicates whether the response list should contain unsegmented access profiles. If `for-segment-ids` is absent or empty, specifying *include-unsegmented* as `false` results in an error.
### Return type ### Return type
[**AccessProfile[]**](../models/access-profile) [**AccessProfile[]**](../models/access-profile)
@@ -435,14 +435,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$ForSubadmin = "8c190e6787aa4ed9a90bd9d5344523fb" # String | If provided, filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID, or the special value **me**, which is shorthand for the calling identity's ID. A 400 Bad Request error is returned if the **for-subadmin** parameter is specified for an identity that is not a subadmin. (optional) $ForSubadmin = "8c190e6787aa4ed9a90bd9d5344523fb" # String | Filters the returned list according to what is visible to the indicated ROLE_SUBADMIN or SOURCE_SUBADMIN identity. The value of the parameter is either an identity ID or the special value **me**, which is shorthand for the calling identity's ID. If you specify an identity that isn't a subadmin, the API returns a 400 Bad Request error. (optional)
$Limit = 50 # Int32 | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 50) $Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
$Filters = 'name eq "SailPoint Support"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Composite operators supported: *and, or* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names. (optional) $Filters = 'name eq "SailPoint Support"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **id**: *eq, in* **name**: *eq, sw* **created**: *gt, lt, ge, le* **modified**: *gt, lt, ge, le* **owner.id**: *eq, in* **requestable**: *eq* **source.id**: *eq, in* Supported composite operators are *and, or* Filtering is not supported for access profiles and entitlements that have the '+' symbol in their names. (optional)
$Sorters = "name,-modified" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified** (optional) $Sorters = "name,-modified" # String | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results) Sorting is supported for the following fields: **name, created, modified** (optional)
$ForSegmentIds = "0b5c9f25-83c6-4762-9073-e38f7bb2ae26,2e8d8180-24bc-4d21-91c6-7affdb473b0d" # String | If present and not empty, additionally filters access profiles to those which are assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error. (optional) $ForSegmentIds = "0b5c9f25-83c6-4762-9073-e38f7bb2ae26,2e8d8180-24bc-4d21-91c6-7affdb473b0d" # String | Filters access profiles to only those assigned to the segment(s) with the specified IDs. If segmentation is currently unavailable, specifying this parameter results in an error. (optional)
$IncludeUnsegmented = $false # Boolean | Indicates whether the response list should contain unsegmented access profiles. If *for-segment-ids* is absent or empty, specifying *include-unsegmented* as false results in an error. (optional) (default to $true) $IncludeUnsegmented = $false # Boolean | Indicates whether the response list should contain unsegmented access profiles. If `for-segment-ids` is absent or empty, specifying *include-unsegmented* as `false` results in an error. (optional) (default to $true)
# List Access Profiles # List Access Profiles

View File

@@ -12,7 +12,7 @@ tags: ['SDK', 'Software Development Kit', 'Approvals', 'V2024Approvals']
# Approvals # Approvals
Use this API to implement approval functionality. With this functionality in place, you can get generic approvals and modify them. Use this API to implement approval functionality. With this functionality in place, you can get generic approvals and modify them.
The main advantages this API has vs [Access Request Approvals](https://developer.sailpoint.com/docs/api/beta/access-request-approvals) are that you can use it to get generic approvals individually or in batches and make changes to those approvals. The main advantages this API has vs [Access Request Approvals](https://developer.sailpoint.com/docs/api/v2024/access-request-approvals) are that you can use it to get generic approvals individually or in batches and make changes to those approvals.

View File

@@ -31,10 +31,12 @@ Method | HTTP request | Description
[**New-V2024Deploy**](#create-deploy) | **POST** `/configuration-hub/deploys` | Create a Deploy [**New-V2024Deploy**](#create-deploy) | **POST** `/configuration-hub/deploys` | Create a Deploy
[**New-V2024ObjectMapping**](#create-object-mapping) | **POST** `/configuration-hub/object-mappings/{sourceOrg}` | Creates an object mapping [**New-V2024ObjectMapping**](#create-object-mapping) | **POST** `/configuration-hub/object-mappings/{sourceOrg}` | Creates an object mapping
[**New-V2024ObjectMappings**](#create-object-mappings) | **POST** `/configuration-hub/object-mappings/{sourceOrg}/bulk-create` | Bulk creates object mappings [**New-V2024ObjectMappings**](#create-object-mappings) | **POST** `/configuration-hub/object-mappings/{sourceOrg}/bulk-create` | Bulk creates object mappings
[**New-V2024ScheduledAction**](#create-scheduled-action) | **POST** `/configuration-hub/scheduled-actions` | Create Scheduled Action
[**New-V2024UploadedConfiguration**](#create-uploaded-configuration) | **POST** `/configuration-hub/backups/uploads` | Upload a Configuration [**New-V2024UploadedConfiguration**](#create-uploaded-configuration) | **POST** `/configuration-hub/backups/uploads` | Upload a Configuration
[**Remove-V2024Backup**](#delete-backup) | **DELETE** `/configuration-hub/backups/{id}` | Delete a Backup [**Remove-V2024Backup**](#delete-backup) | **DELETE** `/configuration-hub/backups/{id}` | Delete a Backup
[**Remove-V2024Draft**](#delete-draft) | **DELETE** `/configuration-hub/drafts/{id}` | Delete a draft [**Remove-V2024Draft**](#delete-draft) | **DELETE** `/configuration-hub/drafts/{id}` | Delete a draft
[**Remove-V2024ObjectMapping**](#delete-object-mapping) | **DELETE** `/configuration-hub/object-mappings/{sourceOrg}/{objectMappingId}` | Deletes an object mapping [**Remove-V2024ObjectMapping**](#delete-object-mapping) | **DELETE** `/configuration-hub/object-mappings/{sourceOrg}/{objectMappingId}` | Deletes an object mapping
[**Remove-V2024ScheduledAction**](#delete-scheduled-action) | **DELETE** `/configuration-hub/scheduled-actions/{id}` | Delete Scheduled Action
[**Remove-V2024UploadedConfiguration**](#delete-uploaded-configuration) | **DELETE** `/configuration-hub/backups/uploads/{id}` | Delete an Uploaded Configuration [**Remove-V2024UploadedConfiguration**](#delete-uploaded-configuration) | **DELETE** `/configuration-hub/backups/uploads/{id}` | Delete an Uploaded Configuration
[**Get-V2024Deploy**](#get-deploy) | **GET** `/configuration-hub/deploys/{id}` | Get a Deploy [**Get-V2024Deploy**](#get-deploy) | **GET** `/configuration-hub/deploys/{id}` | Get a Deploy
[**Get-V2024ObjectMappings**](#get-object-mappings) | **GET** `/configuration-hub/object-mappings/{sourceOrg}` | Gets list of object mappings [**Get-V2024ObjectMappings**](#get-object-mappings) | **GET** `/configuration-hub/object-mappings/{sourceOrg}` | Gets list of object mappings
@@ -42,8 +44,10 @@ Method | HTTP request | Description
[**Get-V2024Backups**](#list-backups) | **GET** `/configuration-hub/backups` | List Backups [**Get-V2024Backups**](#list-backups) | **GET** `/configuration-hub/backups` | List Backups
[**Get-V2024Deploys**](#list-deploys) | **GET** `/configuration-hub/deploys` | List Deploys [**Get-V2024Deploys**](#list-deploys) | **GET** `/configuration-hub/deploys` | List Deploys
[**Get-V2024Drafts**](#list-drafts) | **GET** `/configuration-hub/drafts` | List Drafts [**Get-V2024Drafts**](#list-drafts) | **GET** `/configuration-hub/drafts` | List Drafts
[**Get-V2024ScheduledActions**](#list-scheduled-actions) | **GET** `/configuration-hub/scheduled-actions` | List Scheduled Actions
[**Get-V2024UploadedConfigurations**](#list-uploaded-configurations) | **GET** `/configuration-hub/backups/uploads` | List Uploaded Configurations [**Get-V2024UploadedConfigurations**](#list-uploaded-configurations) | **GET** `/configuration-hub/backups/uploads` | List Uploaded Configurations
[**Update-V2024ObjectMappings**](#update-object-mappings) | **POST** `/configuration-hub/object-mappings/{sourceOrg}/bulk-patch` | Bulk updates object mappings [**Update-V2024ObjectMappings**](#update-object-mappings) | **POST** `/configuration-hub/object-mappings/{sourceOrg}/bulk-patch` | Bulk updates object mappings
[**Update-V2024ScheduledAction**](#update-scheduled-action) | **PATCH** `/configuration-hub/scheduled-actions/{id}` | Update Scheduled Action
## create-deploy ## create-deploy
@@ -218,6 +222,74 @@ try {
``` ```
[[Back to top]](#) [[Back to top]](#)
## create-scheduled-action
This API creates a new scheduled action for the current tenant.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-scheduled-action)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Body | ScheduledActionPayload | [**ScheduledActionPayload**](../models/scheduled-action-payload) | True | The scheduled action creation request body.
### Return type
[**ScheduledActionResponse**](../models/scheduled-action-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | The created scheduled action. | ScheduledActionResponse
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
### Example
```powershell
$ScheduledActionPayload = @"{
"cronString" : "0 0 12 * * ?",
"timeZoneId" : "America/Chicago",
"startTime" : "2024-08-16T14:16:58.389Z",
"jobType" : "BACKUP",
"content" : {
"sourceTenant" : "tenant-name",
"draftId" : "9012b87d-48ca-439a-868f-2160001da8c3",
"name" : "Daily Backup",
"backupOptions" : {
"includeTypes" : [ "ROLE", "IDENTITY_PROFILE" ],
"objectOptions" : {
"SOURCE" : {
"includedNames" : [ "Source1", "Source2" ]
},
"ROLE" : {
"includedNames" : [ "Admin Role", "User Role" ]
}
}
},
"sourceBackupId" : "5678b87d-48ca-439a-868f-2160001da8c2"
}
}"@
# Create Scheduled Action
try {
$Result = ConvertFrom-JsonToScheduledActionPayload -Json $ScheduledActionPayload
New-V2024ScheduledAction -ScheduledActionPayload $Result
# Below is a request that includes all optional parameters
# New-V2024ScheduledAction -ScheduledActionPayload $Result
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024ScheduledAction"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## create-uploaded-configuration ## create-uploaded-configuration
This API uploads a JSON configuration file into a tenant. This API uploads a JSON configuration file into a tenant.
@@ -420,6 +492,52 @@ try {
``` ```
[[Back to top]](#) [[Back to top]](#)
## delete-scheduled-action
This API deletes an existing scheduled action.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/delete-scheduled-action)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Path | ScheduledActionId | **String** | True | The ID of the scheduled action.
### Return type
(empty response body)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
204 | No content - indicates the request was successful but there is no content to be returned in the response. |
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
### Example
```powershell
$ScheduledActionId = "0f11f2a4-7c94-4bf3-a2bd-742580fe3bde" # String | The ID of the scheduled action.
# Delete Scheduled Action
try {
Remove-V2024ScheduledAction -ScheduledActionId $ScheduledActionId
# Below is a request that includes all optional parameters
# Remove-V2024ScheduledAction -ScheduledActionId $ScheduledActionId
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024ScheduledAction"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## delete-uploaded-configuration ## delete-uploaded-configuration
This API deletes an uploaded configuration based on Id. This API deletes an uploaded configuration based on Id.
@@ -744,6 +862,49 @@ try {
``` ```
[[Back to top]](#) [[Back to top]](#)
## list-scheduled-actions
This API gets a list of existing scheduled actions for the current tenant.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/list-scheduled-actions)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
### Return type
[**ScheduledActionResponse[]**](../models/scheduled-action-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | List of existing scheduled actions. | ScheduledActionResponse[]
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
### Example
```powershell
# List Scheduled Actions
try {
Get-V2024ScheduledActions
# Below is a request that includes all optional parameters
# Get-V2024ScheduledActions
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ScheduledActions"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## list-uploaded-configurations ## list-uploaded-configurations
This API gets a list of existing uploaded configurations for the current tenant. This API gets a list of existing uploaded configurations for the current tenant.
@@ -854,3 +1015,62 @@ try {
} }
``` ```
[[Back to top]](#) [[Back to top]](#)
## update-scheduled-action
This API updates an existing scheduled action using JSON Patch format.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/update-scheduled-action)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Path | ScheduledActionId | **String** | True | The ID of the scheduled action.
Body | JsonPatch | [**JsonPatch**](../models/json-patch) | True | The JSON Patch document containing the changes to apply to the scheduled action.
### Return type
[**ScheduledActionResponse**](../models/scheduled-action-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | The updated scheduled action. | ScheduledActionResponse
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: application/json-patch+json
- **Accept**: application/json
### Example
```powershell
$ScheduledActionId = "0f11f2a4-7c94-4bf3-a2bd-742580fe3bde" # String | The ID of the scheduled action.
$JsonPatch = @"{
"operations" : [ {
"op" : "replace",
"path" : "/description",
"value" : "New description"
}, {
"op" : "replace",
"path" : "/description",
"value" : "New description"
} ]
}"@
# Update Scheduled Action
try {
$Result = ConvertFrom-JsonToJsonPatch -Json $JsonPatch
Update-V2024ScheduledAction -ScheduledActionId $ScheduledActionId -JsonPatch $Result
# Below is a request that includes all optional parameters
# Update-V2024ScheduledAction -ScheduledActionId $ScheduledActionId -JsonPatch $Result
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024ScheduledAction"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)

View File

@@ -0,0 +1,312 @@
---
id: v2024-connector-customizers
title: ConnectorCustomizers
pagination_label: ConnectorCustomizers
sidebar_label: ConnectorCustomizers
sidebar_class_name: powershellsdk
keywords: ['powershell', 'PowerShell', 'sdk', 'ConnectorCustomizers', 'V2024ConnectorCustomizers']
slug: /tools/sdk/powershell/v2024/methods/connector-customizers
tags: ['SDK', 'Software Development Kit', 'ConnectorCustomizers', 'V2024ConnectorCustomizers']
---
# ConnectorCustomizers
Saas Connectivity Customizers are cloud-based connector customizers. The customizers allow you to customize the out of the box connectors in a similar way to how you can use rules to customize VA (virtual appliance) based connectors.
Use these APIs to implement connector customizers functionality.
All URIs are relative to *https://sailpoint.api.identitynow.com/v2024*
Method | HTTP request | Description
------------- | ------------- | -------------
[**New-V2024ConnectorCustomizer**](#create-connector-customizer) | **POST** `/connector-customizers` | Create Connector Customizer
[**New-V2024ConnectorCustomizerVersion**](#create-connector-customizer-version) | **POST** `/connector-customizers/{id}/versions` | Creates a connector customizer version
[**Remove-V2024ConnectorCustomizer**](#delete-connector-customizer) | **DELETE** `/connector-customizers/{id}` | Delete Connector Customizer
[**Get-V2024ConnectorCustomizer**](#get-connector-customizer) | **GET** `/connector-customizers/{id}` | Get connector customizer
[**Get-V2024ConnectorCustomizers**](#list-connector-customizers) | **GET** `/connector-customizers` | List All Connector Customizers
[**Send-V2024ConnectorCustomizer**](#put-connector-customizer) | **PUT** `/connector-customizers/{id}` | Update Connector Customizer
## create-connector-customizer
Create a connector customizer.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-connector-customizer)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Body | ConnectorCustomizerCreateRequest | [**ConnectorCustomizerCreateRequest**](../models/connector-customizer-create-request) | True | Connector customizer to create.
### Return type
[**ConnectorCustomizerCreateResponse**](../models/connector-customizer-create-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
201 | Created connector customizer. | ConnectorCustomizerCreateResponse
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
### Example
```powershell
$ConnectorCustomizerCreateRequest = @"{
"name" : "My Custom Connector"
}"@
# Create Connector Customizer
try {
$Result = ConvertFrom-JsonToConnectorCustomizerCreateRequest -Json $ConnectorCustomizerCreateRequest
New-V2024ConnectorCustomizer -ConnectorCustomizerCreateRequest $Result
# Below is a request that includes all optional parameters
# New-V2024ConnectorCustomizer -ConnectorCustomizerCreateRequest $Result
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024ConnectorCustomizer"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## create-connector-customizer-version
Creates a new version for the customizer.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-connector-customizer-version)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | The id of the connector customizer.
### Return type
[**ConnectorCustomizerVersionCreateResponse**](../models/connector-customizer-version-create-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | The created connector customizer version object. | ConnectorCustomizerVersionCreateResponse
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
### Example
```powershell
$Id = "b07dc46a-1498-4de8-bfbb-259a68e70c8a" # String | The id of the connector customizer.
# Creates a connector customizer version
try {
New-V2024ConnectorCustomizerVersion -Id $Id
# Below is a request that includes all optional parameters
# New-V2024ConnectorCustomizerVersion -Id $Id
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024ConnectorCustomizerVersion"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## delete-connector-customizer
Delete the connector customizer for the given ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/delete-connector-customizer)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the connector customizer to delete.
### Return type
(empty response body)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
204 | No content - indicates the request was successful but there is no content to be returned in the response. |
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
### Example
```powershell
$Id = "b07dc46a-1498-4de8-bfbb-259a68e70c8a" # String | ID of the connector customizer to delete.
# Delete Connector Customizer
try {
Remove-V2024ConnectorCustomizer -Id $Id
# Below is a request that includes all optional parameters
# Remove-V2024ConnectorCustomizer -Id $Id
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024ConnectorCustomizer"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## get-connector-customizer
Gets connector customizer by ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-connector-customizer)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the connector customizer to get.
### Return type
[**ConnectorCustomizersResponse**](../models/connector-customizers-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | Connector customizer with the given ID. | ConnectorCustomizersResponse
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
### Example
```powershell
$Id = "b07dc46a-1498-4de8-bfbb-259a68e70c8a" # String | ID of the connector customizer to get.
# Get connector customizer
try {
Get-V2024ConnectorCustomizer -Id $Id
# Below is a request that includes all optional parameters
# Get-V2024ConnectorCustomizer -Id $Id
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorCustomizer"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## list-connector-customizers
List all connector customizers.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/list-connector-customizers)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Limit | **Int32** | (optional) (default to 250) | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
### Return type
[**ConnectorCustomizersResponse[]**](../models/connector-customizers-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | List all connector customizers. | ConnectorCustomizersResponse[]
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
### Example
```powershell
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Limit = 250 # Int32 | Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 250)
# List All Connector Customizers
try {
Get-V2024ConnectorCustomizers
# Below is a request that includes all optional parameters
# Get-V2024ConnectorCustomizers -Offset $Offset -Limit $Limit
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorCustomizers"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)
## put-connector-customizer
Update an existing connector customizer with the one provided in the request body. These fields are immutable: `id`, `name`, `type`.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/put-connector-customizer)
### Parameters
Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the connector customizer to update.
Body | ConnectorCustomizerUpdateRequest | [**ConnectorCustomizerUpdateRequest**](../models/connector-customizer-update-request) | (optional) | Connector rule with updated data.
### Return type
[**ConnectorCustomizerUpdateResponse**](../models/connector-customizer-update-response)
### Responses
Code | Description | Data Type
------------- | ------------- | -------------
200 | Updated connector customizer. | ConnectorCustomizerUpdateResponse
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessProfiles401Response
403 | Forbidden - Returned if the user you are running as, doesn&#39;t have access to this end-point. | ErrorResponseDto
404 | Not Found - returned if the request URL refers to a resource or object that does not exist | ErrorResponseDto
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessProfiles429Response
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
### Example
```powershell
$Id = "b07dc46a-1498-4de8-bfbb-259a68e70c8a" # String | ID of the connector customizer to update.
$ConnectorCustomizerUpdateRequest = @"{
"name" : "My Custom Connector"
}"@
# Update Connector Customizer
try {
Send-V2024ConnectorCustomizer -Id $Id
# Below is a request that includes all optional parameters
# Send-V2024ConnectorCustomizer -Id $Id -ConnectorCustomizerUpdateRequest $Result
} catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Send-V2024ConnectorCustomizer"
Write-Host $_.ErrorDetails
}
```
[[Back to top]](#)

View File

@@ -33,9 +33,6 @@ Method | HTTP request | Description
## create-connector-rule ## create-connector-rule
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Create a connector rule from the available types. Create a connector rule from the available types.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-connector-rule) [API Spec](https://developer.sailpoint.com/docs/api/v2024/create-connector-rule)
@@ -43,7 +40,6 @@ Create a connector rule from the available types.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | ConnectorRuleCreateRequest | [**ConnectorRuleCreateRequest**](../models/connector-rule-create-request) | True | Connector rule to create. Body | ConnectorRuleCreateRequest | [**ConnectorRuleCreateRequest**](../models/connector-rule-create-request) | True | Connector rule to create.
### Return type ### Return type
@@ -65,7 +61,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$ConnectorRuleCreateRequest = @"{ $ConnectorRuleCreateRequest = @"{
"sourceCode" : { "sourceCode" : {
"version" : "1.0", "version" : "1.0",
@@ -97,10 +92,10 @@ $ConnectorRuleCreateRequest = @"{
try { try {
$Result = ConvertFrom-JsonToConnectorRuleCreateRequest -Json $ConnectorRuleCreateRequest $Result = ConvertFrom-JsonToConnectorRuleCreateRequest -Json $ConnectorRuleCreateRequest
New-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -ConnectorRuleCreateRequest $Result New-V2024ConnectorRule -ConnectorRuleCreateRequest $Result
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# New-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -ConnectorRuleCreateRequest $Result # New-V2024ConnectorRule -ConnectorRuleCreateRequest $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024ConnectorRule" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024ConnectorRule"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -109,9 +104,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## delete-connector-rule ## delete-connector-rule
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Delete the connector rule for the given ID. Delete the connector rule for the given ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/delete-connector-rule) [API Spec](https://developer.sailpoint.com/docs/api/v2024/delete-connector-rule)
@@ -120,7 +112,6 @@ Delete the connector rule for the given ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the connector rule to delete. Path | Id | **String** | True | ID of the connector rule to delete.
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
(empty response body) (empty response body)
@@ -143,15 +134,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$Id = "8c190e6787aa4ed9a90bd9d5344523fb" # String | ID of the connector rule to delete. $Id = "8c190e6787aa4ed9a90bd9d5344523fb" # String | ID of the connector rule to delete.
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Delete Connector Rule # Delete Connector Rule
try { try {
Remove-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental Remove-V2024ConnectorRule -Id $Id
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Remove-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental # Remove-V2024ConnectorRule -Id $Id
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024ConnectorRule" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024ConnectorRule"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -160,9 +150,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-connector-rule ## get-connector-rule
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Get a connector rule by ID. Get a connector rule by ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-connector-rule) [API Spec](https://developer.sailpoint.com/docs/api/v2024/get-connector-rule)
@@ -171,7 +158,6 @@ Get a connector rule by ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the connector rule to get. Path | Id | **String** | True | ID of the connector rule to get.
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
[**ConnectorRuleResponse**](../models/connector-rule-response) [**ConnectorRuleResponse**](../models/connector-rule-response)
@@ -194,15 +180,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$Id = "8c190e6787aa4ed9a90bd9d5344523fb" # String | ID of the connector rule to get. $Id = "8c190e6787aa4ed9a90bd9d5344523fb" # String | ID of the connector rule to get.
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Get Connector Rule # Get Connector Rule
try { try {
Get-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental Get-V2024ConnectorRule -Id $Id
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental # Get-V2024ConnectorRule -Id $Id
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorRule" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorRule"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -211,9 +196,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-connector-rule-list ## get-connector-rule-list
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
List existing connector rules. List existing connector rules.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-connector-rule-list) [API Spec](https://developer.sailpoint.com/docs/api/v2024/get-connector-rule-list)
@@ -221,7 +203,6 @@ List existing connector rules.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Query | Limit | **Int32** | (optional) (default to 50) | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Limit | **Int32** | (optional) (default to 50) | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Offset | **Int32** | (optional) (default to 0) | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. Query | Count | **Boolean** | (optional) (default to $false) | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information.
@@ -245,7 +226,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Limit = 50 # Int32 | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 50) $Limit = 50 # Int32 | Note that for this API the maximum value for limit is 50. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 50)
$Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0) $Offset = 0 # Int32 | Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to 0)
$Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false) $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored. Since requesting a total count can have a performance impact, it is recommended not to send **count=true** if that value will not be used. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional) (default to $false)
@@ -253,10 +233,10 @@ $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* respon
# List Connector Rules # List Connector Rules
try { try {
Get-V2024ConnectorRuleList -XSailPointExperimental $XSailPointExperimental Get-V2024ConnectorRuleList
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-V2024ConnectorRuleList -XSailPointExperimental $XSailPointExperimental -Limit $Limit -Offset $Offset -Count $Count # Get-V2024ConnectorRuleList -Limit $Limit -Offset $Offset -Count $Count
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorRuleList" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorRuleList"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -265,9 +245,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## put-connector-rule ## put-connector-rule
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Update an existing connector rule with the one provided in the request body. These fields are immutable: `id`, `name`, `type` Update an existing connector rule with the one provided in the request body. These fields are immutable: `id`, `name`, `type`
[API Spec](https://developer.sailpoint.com/docs/api/v2024/put-connector-rule) [API Spec](https://developer.sailpoint.com/docs/api/v2024/put-connector-rule)
@@ -276,7 +253,6 @@ Update an existing connector rule with the one provided in the request body. The
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | Id | **String** | True | ID of the connector rule to update. Path | Id | **String** | True | ID of the connector rule to update.
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | ConnectorRuleUpdateRequest | [**ConnectorRuleUpdateRequest**](../models/connector-rule-update-request) | (optional) | Connector rule with updated data. Body | ConnectorRuleUpdateRequest | [**ConnectorRuleUpdateRequest**](../models/connector-rule-update-request) | (optional) | Connector rule with updated data.
### Return type ### Return type
@@ -300,7 +276,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$Id = "8c190e6787aa4ed9a90bd9d5344523fb" # String | ID of the connector rule to update. $Id = "8c190e6787aa4ed9a90bd9d5344523fb" # String | ID of the connector rule to update.
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$ConnectorRuleUpdateRequest = @"{ $ConnectorRuleUpdateRequest = @"{
"sourceCode" : { "sourceCode" : {
"version" : "1.0", "version" : "1.0",
@@ -332,10 +307,10 @@ $ConnectorRuleUpdateRequest = @"{
# Update Connector Rule # Update Connector Rule
try { try {
Send-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental Send-V2024ConnectorRule -Id $Id
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Send-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental -ConnectorRuleUpdateRequest $Result # Send-V2024ConnectorRule -Id $Id -ConnectorRuleUpdateRequest $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Send-V2024ConnectorRule" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Send-V2024ConnectorRule"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -344,9 +319,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## test-connector-rule ## test-connector-rule
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Detect issues within the connector rule's code to fix and list them. Detect issues within the connector rule's code to fix and list them.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/test-connector-rule) [API Spec](https://developer.sailpoint.com/docs/api/v2024/test-connector-rule)
@@ -354,7 +326,6 @@ Detect issues within the connector rule's code to fix and list them.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | SourceCode | [**SourceCode**](../models/source-code) | True | Code to validate. Body | SourceCode | [**SourceCode**](../models/source-code) | True | Code to validate.
### Return type ### Return type
@@ -376,7 +347,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$SourceCode = @"{ $SourceCode = @"{
"version" : "1.0", "version" : "1.0",
"script" : "return \"Mr. \" + firstName;" "script" : "return \"Mr. \" + firstName;"
@@ -386,10 +356,10 @@ $SourceCode = @"{
try { try {
$Result = ConvertFrom-JsonToSourceCode -Json $SourceCode $Result = ConvertFrom-JsonToSourceCode -Json $SourceCode
Test-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -SourceCode $Result Test-V2024ConnectorRule -SourceCode $Result
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Test-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -SourceCode $Result # Test-V2024ConnectorRule -SourceCode $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Test-V2024ConnectorRule" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Test-V2024ConnectorRule"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails

View File

@@ -46,9 +46,6 @@ Method | HTTP request | Description
## create-form-definition ## create-form-definition
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-definition) [API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-definition)
@@ -56,7 +53,6 @@ This API is currently in an experimental state. The API is subject to change bas
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | Body | [**CreateFormDefinitionRequest**](../models/create-form-definition-request) | (optional) | Body is the request payload to create form definition request Body | Body | [**CreateFormDefinitionRequest**](../models/create-form-definition-request) | (optional) | Body is the request payload to create form definition request
### Return type ### Return type
@@ -78,7 +74,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Body = @"{ $Body = @"{
"owner" : { "owner" : {
"name" : "Grant Smith", "name" : "Grant Smith",
@@ -194,10 +189,10 @@ $Body = @"{
# Creates a form definition. # Creates a form definition.
try { try {
New-V2024FormDefinition -XSailPointExperimental $XSailPointExperimental New-V2024FormDefinition
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# New-V2024FormDefinition -XSailPointExperimental $XSailPointExperimental -Body $Result # New-V2024FormDefinition -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinition" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinition"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -206,9 +201,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## create-form-definition-dynamic-schema ## create-form-definition-dynamic-schema
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-definition-dynamic-schema) [API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-definition-dynamic-schema)
@@ -216,7 +208,6 @@ This API is currently in an experimental state. The API is subject to change bas
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | Body | [**FormDefinitionDynamicSchemaRequest**](../models/form-definition-dynamic-schema-request) | (optional) | Body is the request payload to create a form definition dynamic schema Body | Body | [**FormDefinitionDynamicSchemaRequest**](../models/form-definition-dynamic-schema-request) | (optional) | Body is the request payload to create a form definition dynamic schema
### Return type ### Return type
@@ -239,7 +230,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Body = @"{ $Body = @"{
"description" : "A description", "description" : "A description",
"attributes" : { "attributes" : {
@@ -253,10 +243,10 @@ $Body = @"{
# Generate JSON Schema dynamically. # Generate JSON Schema dynamically.
try { try {
New-V2024FormDefinitionDynamicSchema -XSailPointExperimental $XSailPointExperimental New-V2024FormDefinitionDynamicSchema
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# New-V2024FormDefinitionDynamicSchema -XSailPointExperimental $XSailPointExperimental -Body $Result # New-V2024FormDefinitionDynamicSchema -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinitionDynamicSchema" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinitionDynamicSchema"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -265,9 +255,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## create-form-definition-file-request ## create-form-definition-file-request
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formDefinitionID}` should match a form definition ID. Parameter `{formDefinitionID}` should match a form definition ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-definition-file-request) [API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-definition-file-request)
@@ -276,7 +263,6 @@ Parameter `{formDefinitionID}` should match a form definition ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormDefinitionID | **String** | True | FormDefinitionID String specifying FormDefinitionID Path | FormDefinitionID | **String** | True | FormDefinitionID String specifying FormDefinitionID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
| File | **System.IO.FileInfo** | True | File specifying the multipart | File | **System.IO.FileInfo** | True | File specifying the multipart
### Return type ### Return type
@@ -303,16 +289,15 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | FormDefinitionID String specifying FormDefinitionID $FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | FormDefinitionID String specifying FormDefinitionID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$File = # System.IO.FileInfo | File specifying the multipart $File = # System.IO.FileInfo | File specifying the multipart
# Upload new form definition file. # Upload new form definition file.
try { try {
New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -File $File New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -File $File
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -File $File # New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -File $File
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinitionFileRequest" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinitionFileRequest"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -321,9 +306,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## create-form-instance ## create-form-instance
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-instance) [API Spec](https://developer.sailpoint.com/docs/api/v2024/create-form-instance)
@@ -331,7 +313,6 @@ This API is currently in an experimental state. The API is subject to change bas
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | Body | [**CreateFormInstanceRequest**](../models/create-form-instance-request) | (optional) | Body is the request payload to create a form instance Body | Body | [**CreateFormInstanceRequest**](../models/create-form-instance-request) | (optional) | Body is the request payload to create a form instance
### Return type ### Return type
@@ -353,7 +334,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Body = @"{ $Body = @"{
"formInput" : { "formInput" : {
"input1" : "Sales" "input1" : "Sales"
@@ -379,10 +359,10 @@ $Body = @"{
# Creates a form instance. # Creates a form instance.
try { try {
New-V2024FormInstance -XSailPointExperimental $XSailPointExperimental New-V2024FormInstance
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# New-V2024FormInstance -XSailPointExperimental $XSailPointExperimental -Body $Result # New-V2024FormInstance -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormInstance" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormInstance"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -391,9 +371,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## delete-form-definition ## delete-form-definition
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formDefinitionID}` should match a form definition ID. Parameter `{formDefinitionID}` should match a form definition ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/delete-form-definition) [API Spec](https://developer.sailpoint.com/docs/api/v2024/delete-form-definition)
@@ -402,7 +379,6 @@ Parameter `{formDefinitionID}` should match a form definition ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormDefinitionID | **String** | True | Form definition ID Path | FormDefinitionID | **String** | True | Form definition ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
[**SystemCollectionsHashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0) [**SystemCollectionsHashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0)
@@ -425,15 +401,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID $FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Deletes a form definition. # Deletes a form definition.
try { try {
Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental # Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024FormDefinition" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024FormDefinition"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -442,9 +417,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## export-form-definitions-by-tenant ## export-form-definitions-by-tenant
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
No parameters required. No parameters required.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/export-form-definitions-by-tenant) [API Spec](https://developer.sailpoint.com/docs/api/v2024/export-form-definitions-by-tenant)
@@ -452,7 +424,6 @@ No parameters required.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Query | Offset | **Int64** | (optional) (default to 0) | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. Query | Offset | **Int64** | (optional) (default to 0) | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0.
Query | Limit | **Int64** | (optional) (default to 250) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. Query | Limit | **Int64** | (optional) (default to 250) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in* Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in*
@@ -477,7 +448,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Offset = 0 # Int64 | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0) $Offset = 0 # Int64 | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0)
$Limit = 250 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 250) $Limit = 250 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 250)
$Filters = 'name sw "my form"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in* (optional) $Filters = 'name sw "my form"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in* (optional)
@@ -486,10 +456,10 @@ $Sorters = "name" # String | Sort results using the standard syntax described in
# List form definitions by tenant. # List form definitions by tenant.
try { try {
Export-V2024FormDefinitionsByTenant -XSailPointExperimental $XSailPointExperimental Export-V2024FormDefinitionsByTenant
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Export-V2024FormDefinitionsByTenant -XSailPointExperimental $XSailPointExperimental -Offset $Offset -Limit $Limit -Filters $Filters -Sorters $Sorters # Export-V2024FormDefinitionsByTenant -Offset $Offset -Limit $Limit -Filters $Filters -Sorters $Sorters
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Export-V2024FormDefinitionsByTenant" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Export-V2024FormDefinitionsByTenant"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -498,9 +468,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-file-from-s3 ## get-file-from-s3
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-file-from-s3) [API Spec](https://developer.sailpoint.com/docs/api/v2024/get-file-from-s3)
@@ -510,7 +477,6 @@ Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormDefinitionID | **String** | True | FormDefinitionID Form definition ID Path | FormDefinitionID | **String** | True | FormDefinitionID Form definition ID
Path | FileID | **String** | True | FileID String specifying the hashed name of the uploaded file we are retrieving. Path | FileID | **String** | True | FileID String specifying the hashed name of the uploaded file we are retrieving.
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
**System.IO.FileInfo** **System.IO.FileInfo**
@@ -535,15 +501,14 @@ Code | Description | Data Type
```powershell ```powershell
$FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | FormDefinitionID Form definition ID $FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | FormDefinitionID Form definition ID
$FileID = "00000031N0J7R2B57M8YG73J7M.png" # String | FileID String specifying the hashed name of the uploaded file we are retrieving. $FileID = "00000031N0J7R2B57M8YG73J7M.png" # String | FileID String specifying the hashed name of the uploaded file we are retrieving.
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Download definition file by fileId. # Download definition file by fileId.
try { try {
Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID -XSailPointExperimental $XSailPointExperimental Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID -XSailPointExperimental $XSailPointExperimental # Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FileFromS3" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FileFromS3"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -552,9 +517,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-form-definition-by-key ## get-form-definition-by-key
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formDefinitionID}` should match a form definition ID. Parameter `{formDefinitionID}` should match a form definition ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-form-definition-by-key) [API Spec](https://developer.sailpoint.com/docs/api/v2024/get-form-definition-by-key)
@@ -563,7 +525,6 @@ Parameter `{formDefinitionID}` should match a form definition ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormDefinitionID | **String** | True | Form definition ID Path | FormDefinitionID | **String** | True | Form definition ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
[**FormDefinitionResponse**](../models/form-definition-response) [**FormDefinitionResponse**](../models/form-definition-response)
@@ -586,15 +547,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID $FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Return a form definition. # Return a form definition.
try { try {
Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental # Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormDefinitionByKey" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormDefinitionByKey"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -603,9 +563,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-form-instance-by-key ## get-form-instance-by-key
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formInstanceID}` should match a form instance ID. Parameter `{formInstanceID}` should match a form instance ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-form-instance-by-key) [API Spec](https://developer.sailpoint.com/docs/api/v2024/get-form-instance-by-key)
@@ -614,7 +571,6 @@ Parameter `{formInstanceID}` should match a form instance ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormInstanceID | **String** | True | Form instance ID Path | FormInstanceID | **String** | True | Form instance ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
[**FormInstanceResponse**](../models/form-instance-response) [**FormInstanceResponse**](../models/form-instance-response)
@@ -637,15 +593,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance ID $FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Returns a form instance. # Returns a form instance.
try { try {
Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental # Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormInstanceByKey" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormInstanceByKey"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -654,9 +609,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## get-form-instance-file ## get-form-instance-file
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-form-instance-file) [API Spec](https://developer.sailpoint.com/docs/api/v2024/get-form-instance-file)
@@ -666,7 +618,6 @@ Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormInstanceID | **String** | True | FormInstanceID Form instance ID Path | FormInstanceID | **String** | True | FormInstanceID Form instance ID
Path | FileID | **String** | True | FileID String specifying the hashed name of the uploaded file we are retrieving. Path | FileID | **String** | True | FileID String specifying the hashed name of the uploaded file we are retrieving.
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
**System.IO.FileInfo** **System.IO.FileInfo**
@@ -691,15 +642,14 @@ Code | Description | Data Type
```powershell ```powershell
$FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | FormInstanceID Form instance ID $FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | FormInstanceID Form instance ID
$FileID = "00000031N0J7R2B57M8YG73J7M.png" # String | FileID String specifying the hashed name of the uploaded file we are retrieving. $FileID = "00000031N0J7R2B57M8YG73J7M.png" # String | FileID String specifying the hashed name of the uploaded file we are retrieving.
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# Download instance file by fileId. # Download instance file by fileId.
try { try {
Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID -XSailPointExperimental $XSailPointExperimental Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID -XSailPointExperimental $XSailPointExperimental # Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormInstanceFile" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormInstanceFile"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -708,9 +658,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## import-form-definitions ## import-form-definitions
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/import-form-definitions) [API Spec](https://developer.sailpoint.com/docs/api/v2024/import-form-definitions)
@@ -718,8 +665,7 @@ This API is currently in an experimental state. The API is subject to change bas
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API. Body | Body | [**[]ImportFormDefinitionsRequestInner**](../models/import-form-definitions-request-inner) | (optional) | Body is the request payload to import form definitions
Body | Body | [**[]ExportFormDefinitionsByTenant200ResponseInner**](../models/export-form-definitions-by-tenant200-response-inner) | (optional) | Body is the request payload to import form definitions
### Return type ### Return type
[**ImportFormDefinitions202Response**](../models/import-form-definitions202-response) [**ImportFormDefinitions202Response**](../models/import-form-definitions202-response)
@@ -740,23 +686,22 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Body = @"[{version=1, self={name=All fields not required, id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, type=FORM_DEFINITION}, object={id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, name=All fields not required, description=description, owner={type=IDENTITY, id=3447d8ec2602455ab6f1e8408a0f0150}, usedBy=[{type=WORKFLOW, id=5008594c-dacc-4295-8fee-41df60477304}, {type=WORKFLOW, id=97e75a75-c179-4fbc-a2da-b5fa4aaa8743}], formInput=[{type=STRING, label=input1, description=A single dynamic scalar value (i.e. number, string, date, etc) that can be passed into the form for use in conditional logic}], formElements=[{id=3069272797630701, elementType=SECTION, config={label=First Section, formElements=[{id=3069272797630700, elementType=TEXT, key=firstName, config={label=First Name}}, {id=3498415402897539, elementType=TEXT, key=lastName, config={label=Last Name}}]}}], formConditions=[{ruleOperator=AND, rules=[{sourceType=INPUT, source=Department, operator=EQ, valueType=STRING, value=Sales}], effects=[{effectType=HIDE, config={element=2614088730489570}}]}], created=2022-10-04T19:27:04.456Z, modified=2022-11-16T20:45:02.172Z}}]"@ # ExportFormDefinitionsByTenant200ResponseInner[] | Body is the request payload to import form definitions (optional) $Body = @"[{version=1, self={name=All fields not required, id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, type=FORM_DEFINITION}, object={id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, name=All fields not required, description=description, owner={type=IDENTITY, id=3447d8ec2602455ab6f1e8408a0f0150}, usedBy=[{type=WORKFLOW, id=5008594c-dacc-4295-8fee-41df60477304}, {type=WORKFLOW, id=97e75a75-c179-4fbc-a2da-b5fa4aaa8743}], formInput=[{type=STRING, label=input1, description=A single dynamic scalar value (i.e. number, string, date, etc) that can be passed into the form for use in conditional logic}], formElements=[{id=3069272797630701, elementType=SECTION, config={label=First Section, formElements=[{id=3069272797630700, elementType=TEXT, key=firstName, config={label=First Name}}, {id=3498415402897539, elementType=TEXT, key=lastName, config={label=Last Name}}]}}], formConditions=[{ruleOperator=AND, rules=[{sourceType=INPUT, source=Department, operator=EQ, valueType=STRING, value=Sales}], effects=[{effectType=HIDE, config={element=2614088730489570}}]}], created=2022-10-04T19:27:04.456Z, modified=2022-11-16T20:45:02.172Z}}]"@ # ImportFormDefinitionsRequestInner[] | Body is the request payload to import form definitions (optional)
# Import form definitions from export. # Import form definitions from export.
try { try {
Import-V2024FormDefinitions -XSailPointExperimental $XSailPointExperimental Import-V2024FormDefinitions
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Import-V2024FormDefinitions -XSailPointExperimental $XSailPointExperimental -Body $Result # Import-V2024FormDefinitions -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Import-V2024FormDefinitions" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Import-V2024FormDefinitions"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -765,9 +710,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## patch-form-definition ## patch-form-definition
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formDefinitionID}` should match a form definition ID. Parameter `{formDefinitionID}` should match a form definition ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/patch-form-definition) [API Spec](https://developer.sailpoint.com/docs/api/v2024/patch-form-definition)
@@ -776,7 +718,6 @@ Parameter `{formDefinitionID}` should match a form definition ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormDefinitionID | **String** | True | Form definition ID Path | FormDefinitionID | **String** | True | Form definition ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | Body | [**[]System.Collections.Hashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0) | (optional) | Body is the request payload to patch a form definition, check: https://jsonpatch.com Body | Body | [**[]System.Collections.Hashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0) | (optional) | Body is the request payload to patch a form definition, check: https://jsonpatch.com
### Return type ### Return type
@@ -800,7 +741,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID $FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Body = @{ key_example = } # Map[] | Body is the request payload to patch a form definition, check: https://jsonpatch.com (optional) $Body = @{ key_example = } # Map[] | Body is the request payload to patch a form definition, check: https://jsonpatch.com (optional)
$Body = @"[{op=replace, path=/description, value=test-description}]"@ # Map[] | Body is the request payload to patch a form definition, check: https://jsonpatch.com (optional) $Body = @"[{op=replace, path=/description, value=test-description}]"@ # Map[] | Body is the request payload to patch a form definition, check: https://jsonpatch.com (optional)
@@ -808,10 +748,10 @@ $Body = @{ key_example = } # Map[] | Body is the request payload to patch a for
# Patch a form definition. # Patch a form definition.
try { try {
Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -Body $Result # Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024FormDefinition" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024FormDefinition"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -820,9 +760,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## patch-form-instance ## patch-form-instance
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formInstanceID}` should match a form instance ID. Parameter `{formInstanceID}` should match a form instance ID.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/patch-form-instance) [API Spec](https://developer.sailpoint.com/docs/api/v2024/patch-form-instance)
@@ -831,7 +768,6 @@ Parameter `{formInstanceID}` should match a form instance ID.
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormInstanceID | **String** | True | Form instance ID Path | FormInstanceID | **String** | True | Form instance ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Body | Body | [**[]System.Collections.Hashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0) | (optional) | Body is the request payload to patch a form instance, check: https://jsonpatch.com Body | Body | [**[]System.Collections.Hashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0) | (optional) | Body is the request payload to patch a form instance, check: https://jsonpatch.com
### Return type ### Return type
@@ -856,7 +792,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance ID $FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Body = @{ key_example = } # Map[] | Body is the request payload to patch a form instance, check: https://jsonpatch.com (optional) $Body = @{ key_example = } # Map[] | Body is the request payload to patch a form instance, check: https://jsonpatch.com (optional)
$Body = @"[{op=replace, path=/state, value=SUBMITTED}, {op=replace, path=/formData, value={a-key-1=a-value-1, a-key-2=true, a-key-3=1}}]"@ # Map[] | Body is the request payload to patch a form instance, check: https://jsonpatch.com (optional) $Body = @"[{op=replace, path=/state, value=SUBMITTED}, {op=replace, path=/formData, value={a-key-1=a-value-1, a-key-2=true, a-key-3=1}}]"@ # Map[] | Body is the request payload to patch a form instance, check: https://jsonpatch.com (optional)
@@ -864,10 +799,10 @@ $Body = @{ key_example = } # Map[] | Body is the request payload to patch a for
# Patch a form instance. # Patch a form instance.
try { try {
Update-V2024FormInstance -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental Update-V2024FormInstance -FormInstanceID $FormInstanceID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Update-V2024FormInstance -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental -Body $Result # Update-V2024FormInstance -FormInstanceID $FormInstanceID -Body $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024FormInstance" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024FormInstance"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -876,9 +811,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## search-form-definitions-by-tenant ## search-form-definitions-by-tenant
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
No parameters required. No parameters required.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/search-form-definitions-by-tenant) [API Spec](https://developer.sailpoint.com/docs/api/v2024/search-form-definitions-by-tenant)
@@ -886,7 +818,6 @@ No parameters required.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Query | Offset | **Int64** | (optional) (default to 0) | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. Query | Offset | **Int64** | (optional) (default to 0) | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0.
Query | Limit | **Int64** | (optional) (default to 250) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. Query | Limit | **Int64** | (optional) (default to 250) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in* Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in*
@@ -911,7 +842,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Offset = 250 # Int64 | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0) $Offset = 250 # Int64 | Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0)
$Limit = 250 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 250) $Limit = 250 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 250)
$Filters = 'name sw "my form"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in* (optional) $Filters = 'name sw "my form"' # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **name**: *eq, gt, sw, in* **description**: *eq, gt, sw, in* **created**: *eq, gt, sw, in* **modified**: *eq, gt, sw, in* (optional)
@@ -920,10 +850,10 @@ $Sorters = "name" # String | Sort results using the standard syntax described in
# Export form definitions by tenant. # Export form definitions by tenant.
try { try {
Search-V2024FormDefinitionsByTenant -XSailPointExperimental $XSailPointExperimental Search-V2024FormDefinitionsByTenant
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Search-V2024FormDefinitionsByTenant -XSailPointExperimental $XSailPointExperimental -Offset $Offset -Limit $Limit -Filters $Filters -Sorters $Sorters # Search-V2024FormDefinitionsByTenant -Offset $Offset -Limit $Limit -Filters $Filters -Sorters $Sorters
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormDefinitionsByTenant" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormDefinitionsByTenant"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -932,9 +862,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## search-form-element-data-by-element-id ## search-form-element-data-by-element-id
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
Parameter `{formInstanceID}` should match a form instance ID. Parameter `{formInstanceID}` should match a form instance ID.
Parameter `{formElementID}` should match a form element ID at the data source configuration. Parameter `{formElementID}` should match a form element ID at the data source configuration.
@@ -945,7 +872,6 @@ Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormInstanceID | **String** | True | Form instance ID Path | FormInstanceID | **String** | True | Form instance ID
Path | FormElementID | **String** | True | Form element ID Path | FormElementID | **String** | True | Form element ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Query | Limit | **Int64** | (optional) (default to 250) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. Query | Limit | **Int64** | (optional) (default to 250) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"")` Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"")`
Query | Query | **String** | (optional) | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields. Query | Query | **String** | (optional) | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields.
@@ -972,7 +898,6 @@ Code | Description | Data Type
```powershell ```powershell
$FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance ID $FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance ID
$FormElementID = "1" # String | Form element ID $FormElementID = "1" # String | Form element ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Limit = 250 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 250) $Limit = 250 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 250)
$Filters = 'value eq "ID01"" # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"')` (optional) $Filters = 'value eq "ID01"" # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"')` (optional)
$Query = "support" # String | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields. (optional) $Query = "support" # String | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields. (optional)
@@ -980,10 +905,10 @@ $Query = "support" # String | String that is passed to the underlying API to fil
# Retrieves dynamic data by element. # Retrieves dynamic data by element.
try { try {
Search-V2024FormElementDataByElementID -FormInstanceID $FormInstanceID -FormElementID $FormElementID -XSailPointExperimental $XSailPointExperimental Search-V2024FormElementDataByElementID -FormInstanceID $FormInstanceID -FormElementID $FormElementID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Search-V2024FormElementDataByElementID -FormInstanceID $FormInstanceID -FormElementID $FormElementID -XSailPointExperimental $XSailPointExperimental -Limit $Limit -Filters $Filters -Query $Query # Search-V2024FormElementDataByElementID -FormInstanceID $FormInstanceID -FormElementID $FormElementID -Limit $Limit -Filters $Filters -Query $Query
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormElementDataByElementID" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormElementDataByElementID"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -992,9 +917,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## search-form-instances-by-tenant ## search-form-instances-by-tenant
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
No parameters required. No parameters required.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/search-form-instances-by-tenant) [API Spec](https://developer.sailpoint.com/docs/api/v2024/search-form-instances-by-tenant)
@@ -1002,7 +924,6 @@ No parameters required.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
[**ListFormInstancesByTenantResponse[]**](../models/list-form-instances-by-tenant-response) [**ListFormInstancesByTenantResponse[]**](../models/list-form-instances-by-tenant-response)
@@ -1023,15 +944,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# List form instances by tenant. # List form instances by tenant.
try { try {
Search-V2024FormInstancesByTenant -XSailPointExperimental $XSailPointExperimental Search-V2024FormInstancesByTenant
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Search-V2024FormInstancesByTenant -XSailPointExperimental $XSailPointExperimental # Search-V2024FormInstancesByTenant
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormInstancesByTenant" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormInstancesByTenant"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -1040,9 +960,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## search-pre-defined-select-options ## search-pre-defined-select-options
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
No parameters required. No parameters required.
[API Spec](https://developer.sailpoint.com/docs/api/v2024/search-pre-defined-select-options) [API Spec](https://developer.sailpoint.com/docs/api/v2024/search-pre-defined-select-options)
@@ -1050,7 +967,6 @@ No parameters required.
### Parameters ### Parameters
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
### Return type ### Return type
[**ListPredefinedSelectOptionsResponse**](../models/list-predefined-select-options-response) [**ListPredefinedSelectOptionsResponse**](../models/list-predefined-select-options-response)
@@ -1071,15 +987,14 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
# List predefined select options. # List predefined select options.
try { try {
Search-V2024PreDefinedSelectOptions -XSailPointExperimental $XSailPointExperimental Search-V2024PreDefinedSelectOptions
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Search-V2024PreDefinedSelectOptions -XSailPointExperimental $XSailPointExperimental # Search-V2024PreDefinedSelectOptions
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024PreDefinedSelectOptions" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024PreDefinedSelectOptions"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails
@@ -1088,9 +1003,6 @@ try {
[[Back to top]](#) [[Back to top]](#)
## show-preview-data-source ## show-preview-data-source
:::warning experimental
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to `true` to use this endpoint.
:::
[API Spec](https://developer.sailpoint.com/docs/api/v2024/show-preview-data-source) [API Spec](https://developer.sailpoint.com/docs/api/v2024/show-preview-data-source)
@@ -1099,7 +1011,6 @@ This API is currently in an experimental state. The API is subject to change bas
Param Type | Name | Data Type | Required | Description Param Type | Name | Data Type | Required | Description
------------- | ------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | ------------- | -------------
Path | FormDefinitionID | **String** | True | Form definition ID Path | FormDefinitionID | **String** | True | Form definition ID
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
Query | Limit | **Int64** | (optional) (default to 10) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. Query | Limit | **Int64** | (optional) (default to 10) | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used.
Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"")` Query | Filters | **String** | (optional) | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"")`
Query | Query | **String** | (optional) | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields. Query | Query | **String** | (optional) | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields.
@@ -1126,7 +1037,6 @@ Code | Description | Data Type
### Example ### Example
```powershell ```powershell
$FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID $FormDefinitionID = "00000000-0000-0000-0000-000000000000" # String | Form definition ID
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
$Limit = 10 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 10) $Limit = 10 # Int64 | Limit Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). If it is not specified, a default limit is used. (optional) (default to 10)
$Filters = 'value eq "ID01"" # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"')` (optional) $Filters = 'value eq "ID01"" # String | Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results) Filtering is supported for the following fields and operators: **value**: *eq, ne, in* Supported composite operators: *not* Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (""ID01"')` (optional)
$Query = "ac" # String | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields. (optional) $Query = "ac" # String | String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a ""starts with"" filter against several fields. (optional)
@@ -1145,10 +1055,10 @@ $FormElementPreviewRequest = @"{
# Preview form definition data source. # Preview form definition data source.
try { try {
Show-V2024PreviewDataSource -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental Show-V2024PreviewDataSource -FormDefinitionID $FormDefinitionID
# Below is a request that includes all optional parameters # Below is a request that includes all optional parameters
# Show-V2024PreviewDataSource -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -Limit $Limit -Filters $Filters -Query $Query -FormElementPreviewRequest $Result # Show-V2024PreviewDataSource -FormDefinitionID $FormDefinitionID -Limit $Limit -Filters $Filters -Query $Query -FormElementPreviewRequest $Result
} catch { } catch {
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Show-V2024PreviewDataSource" Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Show-V2024PreviewDataSource"
Write-Host $_.ErrorDetails Write-Host $_.ErrorDetails

Some files were not shown because too many files have changed in this diff Show More