mirror of
https://github.com/LukeHagar/developer.sailpoint.com.git
synced 2025-12-07 20:37:46 +00:00
Merge main and v2025 branch
This commit is contained in:
2
.github/workflows/infra-deploy.yml
vendored
2
.github/workflows/infra-deploy.yml
vendored
@@ -38,6 +38,7 @@ jobs:
|
||||
role-to-assume: arn:aws:iam::176038645705:role/github-action-role
|
||||
role-session-name: deploy-developer-site-infra-to-aws
|
||||
aws-region: us-east-1
|
||||
role-duration-seconds: 7200
|
||||
|
||||
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
|
||||
- name: Check out repo
|
||||
@@ -83,7 +84,6 @@ jobs:
|
||||
export NODE_OPTIONS="--max_old_space_size=16384"
|
||||
export DOCUSAURUS_IGNORE_SSG_WARNINGS=true
|
||||
npm ci
|
||||
npm run gen-all-api-specs-code-examples
|
||||
npm run gen-api-docs-all
|
||||
npm run build
|
||||
# push these files to AWS
|
||||
|
||||
7
.gitignore
vendored
7
.gitignore
vendored
@@ -30,6 +30,13 @@ yarn.lock
|
||||
/products/iiq/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/beta/*
|
||||
/docs/api/iiq
|
||||
|
||||
@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
|
||||
|
||||
| API | Postman Collection |
|
||||
| --- | --- |
|
||||
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
|
||||
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
|
||||
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
|
||||
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |
|
||||
|
||||
@@ -20,6 +20,7 @@ Each ISC API version is broken out into a separate collection within the workspa
|
||||
|
||||
| API | Postman Collection |
|
||||
| --- | --- |
|
||||
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
|
||||
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
|
||||
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
|
||||
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |
|
||||
|
||||
@@ -19,3 +19,9 @@ There is a rate limit of 100 requests per `access_token` per 10 seconds for V3 A
|
||||
**Headers**:
|
||||
|
||||
- **Retry-After**: [seconds to wait before rate limit resets]
|
||||
|
||||
:::info
|
||||
|
||||
Specific APIs may have different rate limiting. Refer to their specifications for this information.
|
||||
|
||||
:::
|
||||
|
||||
@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
|
||||
|
||||
| API | Postman Collection |
|
||||
| --- | --- |
|
||||
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
|
||||
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
|
||||
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
|
||||
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |
|
||||
|
||||
@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
|
||||
|
||||
| API | Postman Collection |
|
||||
| --- | --- |
|
||||
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
|
||||
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
|
||||
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
|
||||
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |
|
||||
|
||||
@@ -21,6 +21,7 @@ Each ISC API version is broken out into a separate collection within the workspa
|
||||
|
||||
| API | Postman Collection |
|
||||
| --- | --- |
|
||||
| V2025 API | <CMSLinkComponent source="v2025CollectionUrl"></CMSLinkComponent> |
|
||||
| V2024 API | <CMSLinkComponent source="v2024CollectionUrl"></CMSLinkComponent> |
|
||||
| V3 API | <CMSLinkComponent source="v3CollectionUrl"></CMSLinkComponent> |
|
||||
| Beta API | <CMSLinkComponent source="betaCollectionUrl"></CMSLinkComponent> |
|
||||
|
||||
@@ -136,8 +136,7 @@ You cannot import Non-Employee sources.
|
||||
|
||||
**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.
|
||||
Object configurations containing "importUrl" and "exportUrl" are available for export/import.
|
||||
[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.
|
||||
|
||||
<Tabs>
|
||||
<TabItem value="request" label="Request" default>
|
||||
|
||||
@@ -33,7 +33,7 @@ This is an example input from this trigger:
|
||||
|
||||
## 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 configured a source and loaded account data.
|
||||
|
||||
@@ -10,12 +10,6 @@ slug: /extensibility/event-triggers/triggers/identity-deleted
|
||||
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
|
||||
|
||||

|
||||
|
||||
@@ -10,14 +10,14 @@ slug: /extensibility/event-triggers/triggers/source-account-created
|
||||
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.
|
||||
|
||||
Use this event trigger to watch for new accounts with highly privileged access, such as an account created in Active Directory Domain Admins.
|
||||
|
||||
@@ -10,14 +10,14 @@ slug: /extensibility/event-triggers/triggers/source-account-deleted
|
||||
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.
|
||||
|
||||
Use this event trigger to watch for deletions of authoritative accounts, such as an account deleted on Workday.
|
||||
|
||||
@@ -10,14 +10,14 @@ slug: /extensibility/event-triggers/triggers/source-account-updated
|
||||
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:
|
||||
|
||||
- Update account attributes
|
||||
|
||||
@@ -1,19 +1,19 @@
|
||||
---
|
||||
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
|
||||
sidebar_label: Identity Security Cloud Rule Utility
|
||||
sidebar_position: 4
|
||||
sidebar_class_name: ruleUtility
|
||||
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
|
||||
tags: ['Rules']
|
||||
---
|
||||
|
||||
## 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.
|
||||
|
||||
|
||||
@@ -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
|
||||
{
|
||||
|
||||
90
docs/reporting/access-intelligence-center/ciem-er-diagram.md
Normal file
90
docs/reporting/access-intelligence-center/ciem-er-diagram.md
Normal 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 service’s 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 service’s 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 resource’s 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>
|
||||
@@ -3,7 +3,7 @@ id: access-intelligence-center-videos
|
||||
title: Access Intelligence Center Videos
|
||||
pagination_label: Access Intelligence Center Videos
|
||||
sidebar_label: Videos
|
||||
sidebar_position: 2
|
||||
sidebar_position: 3
|
||||
sidebar_class_name: AccessIntelligenceCenter
|
||||
keywords: ['data listing', 'data share', 'secure data sharing']
|
||||
description: Access Intelligence Center Videos
|
||||
|
||||
@@ -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 'AD Developers' 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.
|
||||
|
||||
@@ -62,9 +62,9 @@ Method | HTTP request | Description
|
||||
|
||||
|
||||
## create-access-profile
|
||||
Use this API to 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.
|
||||
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.
|
||||
Create an access profile.
|
||||
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.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/beta/create-access-profile)
|
||||
|
||||
@@ -397,22 +397,22 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## list-access-profiles
|
||||
Use this API to 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.
|
||||
Get a list of access profiles.
|
||||
>**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)
|
||||
|
||||
### Parameters
|
||||
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 | 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 | 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 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 | 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 | 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 | 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 | 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.
|
||||
|
||||
### Return type
|
||||
[**AccessProfile[]**](../models/access-profile)
|
||||
@@ -433,14 +433,14 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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)
|
||||
$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)
|
||||
$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 = 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)
|
||||
$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)
|
||||
$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)
|
||||
$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)
|
||||
$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)
|
||||
|
||||
# List Access Profiles
|
||||
|
||||
|
||||
@@ -17,14 +17,14 @@ All URIs are relative to *https://sailpoint.api.identitynow.com/beta*
|
||||
|
||||
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-BetaAccessRequestRecommendationsRequestedItem**](#add-access-request-recommendations-requested-item) | **POST** `/ai-access-request-recommendations/requested-items` | Notification of Requested Access Request Recommendations
|
||||
[**Add-BetaAccessRequestRecommendationsViewedItem**](#add-access-request-recommendations-viewed-item) | **POST** `/ai-access-request-recommendations/viewed-items` | Notification of 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-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` | Accept Access Request Recommendation
|
||||
[**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` | Bulk Mark Viewed 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-BetaAccessRequestRecommendationsRequestedItems**](#get-access-request-recommendations-requested-items) | **GET** `/ai-access-request-recommendations/requested-items` | List of Requested 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-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 Accepted 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
|
||||
@@ -64,7 +64,7 @@ $AccessRequestRecommendationActionItemDto = @"{
|
||||
"identityId" : "2c91808570313110017040b06f344ec9"
|
||||
}"@
|
||||
|
||||
# Notification of Ignored Access Request Recommendations
|
||||
# Ignore Access Request Recommendation
|
||||
|
||||
try {
|
||||
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
|
||||
@@ -116,7 +116,7 @@ $AccessRequestRecommendationActionItemDto = @"{
|
||||
"identityId" : "2c91808570313110017040b06f344ec9"
|
||||
}"@
|
||||
|
||||
# Notification of Requested Access Request Recommendations
|
||||
# Accept Access Request Recommendation
|
||||
|
||||
try {
|
||||
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
|
||||
@@ -168,7 +168,7 @@ $AccessRequestRecommendationActionItemDto = @"{
|
||||
"identityId" : "2c91808570313110017040b06f344ec9"
|
||||
}"@
|
||||
|
||||
# Notification of Viewed Access Request Recommendations
|
||||
# Mark Viewed Access Request Recommendations
|
||||
|
||||
try {
|
||||
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
|
||||
@@ -221,7 +221,7 @@ Code | Description | Data Type
|
||||
}"@ # 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 {
|
||||
$Result = ConvertFrom-JsonToAccessRequestRecommendationActionItemDto -Json $AccessRequestRecommendationActionItemDto
|
||||
@@ -272,12 +272,12 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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)
|
||||
$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)
|
||||
$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
|
||||
|
||||
@@ -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)
|
||||
$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 {
|
||||
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)
|
||||
$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)
|
||||
$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 {
|
||||
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)
|
||||
$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)
|
||||
$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 {
|
||||
Get-BetaAccessRequestRecommendationsViewedItems
|
||||
|
||||
@@ -17,7 +17,7 @@ All URIs are relative to *https://sailpoint.api.identitynow.com/beta*
|
||||
|
||||
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
|
||||
[**Update-BetaRecommendationsConfig**](#update-recommendations-config) | **PUT** `/recommendations/config` | Update certification recommendation config values
|
||||
|
||||
@@ -71,7 +71,7 @@ $RecommendationRequestDto = @"{
|
||||
"includeDebugInformation" : true
|
||||
}"@
|
||||
|
||||
# Returns a Recommendation Based on Object
|
||||
# Returns Recommendation Based on Object
|
||||
|
||||
try {
|
||||
$Result = ConvertFrom-JsonToRecommendationRequestDto -Json $RecommendationRequestDto
|
||||
@@ -105,6 +105,7 @@ Code | Description | Data Type
|
||||
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'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
|
||||
|
||||
### HTTP request headers
|
||||
@@ -148,6 +149,7 @@ Code | Description | Data Type
|
||||
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'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
|
||||
|
||||
### HTTP request headers
|
||||
|
||||
@@ -24,7 +24,7 @@ Method | HTTP request | Description
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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 | 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 | 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 | 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) | 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`. 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 | 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.
|
||||
@@ -62,13 +62,13 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```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)
|
||||
$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)
|
||||
$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)
|
||||
$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)
|
||||
$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 | 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`. 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)
|
||||
$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)
|
||||
|
||||
@@ -59,7 +59,7 @@ Method | HTTP request | Description
|
||||
[**Remove-BetaRole**](#delete-role) | **DELETE** `/roles/{id}` | Delete 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-BetaRoleEntitlements**](#get-role-entitlements) | **GET** `/roles/{id}/entitlements` | List role's Entitlements
|
||||
[**Get-BetaRoleEntitlements**](#get-role-entitlements) | **GET** `/roles/{id}/entitlements` | List Role's Entitlements
|
||||
[**Get-BetaRoles**](#list-roles) | **GET** `/roles` | List Roles
|
||||
[**Update-BetaRole**](#patch-role) | **PATCH** `/roles/{id}` | Patch a specified Role
|
||||
|
||||
@@ -473,17 +473,15 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## get-role-entitlements
|
||||
This API lists the Entitlements associated with a given role.
|
||||
|
||||
A token with API, ORG_ADMIN, ROLE_ADMIN, or ROLE_SUBADMIN authority is required to call this API.
|
||||
Get a list of entitlements associated with a specified role.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/beta/get-role-entitlements)
|
||||
|
||||
### Parameters
|
||||
Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
Path | Id | **String** | True | ID of the containing role
|
||||
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.
|
||||
Path | Id | **String** | True | Containing role's ID.
|
||||
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 | 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*
|
||||
@@ -508,14 +506,14 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$Id = "2c91808a7813090a017814121919ecca" # String | ID of the containing role
|
||||
$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)
|
||||
$Id = "2c91808a7813090a017814121919ecca" # String | Containing role's ID.
|
||||
$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)
|
||||
$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)
|
||||
$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 {
|
||||
Get-BetaRoleEntitlements -Id $Id
|
||||
|
||||
@@ -43,8 +43,8 @@ Method | HTTP request | Description
|
||||
|
||||
|
||||
## 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.
|
||||
A token with ORG_ADMIN authority is required to call this API.
|
||||
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.
|
||||
>**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)
|
||||
|
||||
@@ -143,7 +143,7 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
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
|
||||
[**SearchAttributeConfig[]**](../models/search-attribute-config)
|
||||
@@ -159,6 +161,7 @@ Param Type | Name | Data Type | Required | Description
|
||||
Code | Description | Data Type
|
||||
------------- | ------------- | -------------
|
||||
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
|
||||
403 | Forbidden - Returned if the user you are running as, doesn'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
|
||||
@@ -170,6 +173,8 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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
|
||||
|
||||
@@ -177,7 +182,7 @@ try {
|
||||
Get-BetaSearchAttributeConfig
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Get-BetaSearchAttributeConfig
|
||||
# Get-BetaSearchAttributeConfig -Limit $Limit -Offset $Offset
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-BetaSearchAttributeConfig"
|
||||
Write-Host $_.ErrorDetails
|
||||
|
||||
@@ -10,7 +10,12 @@ tags: ['SDK', 'Software Development Kit', 'Transforms', 'BetaTransforms']
|
||||
---
|
||||
|
||||
# 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*
|
||||
|
||||
@@ -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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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
|
||||
[**WorkItems**](../models/work-items)
|
||||
@@ -152,16 +153,20 @@ Code | Description | Data Type
|
||||
------------- | ------------- | -------------
|
||||
200 | A WorkItems object | WorkItems
|
||||
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'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. | ListAccessModelMetadataAttribute429Response
|
||||
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
|
||||
|
||||
### HTTP request headers
|
||||
- **Content-Type**: Not defined
|
||||
- **Content-Type**: application/json
|
||||
- **Accept**: application/json
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$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
|
||||
|
||||
@@ -169,7 +174,7 @@ try {
|
||||
Complete-BetaWorkItem -Id $Id
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Complete-BetaWorkItem -Id $Id
|
||||
# Complete-BetaWorkItem -Id $Id -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Complete-BetaWorkItem"
|
||||
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.
|
||||
|
||||
### Return type
|
||||
[**WorkItems[]**](../models/work-items)
|
||||
[**SystemCollectionsHashtable**](https://learn.microsoft.com/en-us/dotnet/api/system.collections.hashtable?view=net-9.0)
|
||||
|
||||
### Responses
|
||||
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
|
||||
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'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. | ListAccessModelMetadataAttribute429Response
|
||||
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto
|
||||
|
||||
### HTTP request headers
|
||||
- **Content-Type**: Not defined
|
||||
@@ -392,8 +400,8 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$Id = "MyId" # String | ID of the work item.
|
||||
$OwnerId = "MyOwnerId" # String | ID of the work item owner. (optional)
|
||||
$Id = "2c9180835d191a86015d28455b4a2329" # String | ID of the work item.
|
||||
$OwnerId = "2c9180835d191a86015d28455b4a2329" # String | ID of the work item owner. (optional)
|
||||
|
||||
# Get a Work Item
|
||||
|
||||
|
||||
@@ -910,7 +910,9 @@ $WorkflowBody = @"{
|
||||
"trigger" : {
|
||||
"displayName" : "displayName",
|
||||
"attributes" : {
|
||||
"description" : "description",
|
||||
"description" : "Triggered when an identity's manager attribute changes",
|
||||
"formDefinitionId" : "Admin_Access_Request_Form",
|
||||
"attributeToFilter" : "LifecycleState",
|
||||
"id" : "idn:identity-attributes-changed",
|
||||
"filter.$" : "$.changes[?(@.attribute == 'manager')]"
|
||||
},
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'AccessItemApproverDto', 'BetaAccessIt
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who approved the access item request. | [optional]
|
||||
**Id** | **String** | ID of identity who approved the access item request. | [optional]
|
||||
**Name** | **String** | Human-readable display name 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 the identity who approved the access item request. | [optional]
|
||||
**Name** | **String** | Name of the identity who approved the access item request. | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -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]](#)
|
||||
|
||||
@@ -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]](#)
|
||||
|
||||
@@ -21,7 +21,7 @@ Name | Type | Description | Notes
|
||||
**Description** | **String** | Information about the Access Profile | [optional]
|
||||
**Created** | **System.DateTime** | Date the Access Profile was created | [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]
|
||||
**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]
|
||||
|
||||
@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestDynamicApprover', 'BetaA
|
||||
|
||||
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]
|
||||
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required]
|
||||
**RequestedItems** | [**[]AccessRequestDynamicApproverRequestedItemsInner**](access-request-dynamic-approver-requested-items-inner) | The access items that are being requested. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [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** | [**[]AccessItemRequestedForDto1**](access-item-requested-for-dto1) | Identities access was requested for. | [required]
|
||||
**RequestedItems** | [**[]AccessRequestDynamicApproverRequestedItemsInner**](access-request-dynamic-approver-requested-items-inner) | Requested access items. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,12 +16,12 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestDynamicApproverRequested
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the access item. | [required]
|
||||
**Name** | **String** | Human friendly name of the access item. | [required]
|
||||
**Description** | **String** | Extended description of the access item. | [optional]
|
||||
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | The type of access item being requested. | [required]
|
||||
**Operation** | **Enum** [ "Add", "Remove" ] | Grant or revoke the access item | [required]
|
||||
**Comment** | **String** | A comment from the requestor on why the access is needed. | [optional]
|
||||
**Id** | **String** | Access item's unique identifier. | [required]
|
||||
**Name** | **String** | Access item's name. | [required]
|
||||
**Description** | **String** | Access item's extended description. | [optional]
|
||||
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | Type of access item being requested. | [required]
|
||||
**Operation** | **Enum** [ "Add", "Remove" ] | Action to perform on the requested access item. | [required]
|
||||
**Comment** | **String** | Comment from the requester about why the access is necessary. | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApproval', 'BetaAcce
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**AccessRequestId** | **String** | The unique ID of the access request. | [required]
|
||||
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required]
|
||||
**RequestedItemsStatus** | [**[]AccessRequestPostApprovalRequestedItemsStatusInner**](access-request-post-approval-requested-items-status-inner) | Details on the outcome of each access item. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required]
|
||||
**AccessRequestId** | **String** | Access request's unique ID. | [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 about the outcome of each requested access item. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApprovalRequestedIte
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the access item being requested. | [required]
|
||||
**Name** | **String** | The human friendly name of the access item. | [required]
|
||||
**Description** | **String** | Detailed description of the access item. | [optional]
|
||||
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | The type of access item. | [required]
|
||||
**Operation** | **Enum** [ "Add", "Remove" ] | The action to perform on the access item. | [required]
|
||||
**Comment** | **String** | A comment from the identity requesting the access. | [optional]
|
||||
**Id** | **String** | Access item's unique ID. | [required]
|
||||
**Name** | **String** | Access item's name. | [required]
|
||||
**Description** | **String** | Access item's description. | [optional]
|
||||
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | Access item's type. | [required]
|
||||
**Operation** | **Enum** [ "Add", "Remove" ] | Action to perform on the requested access item. | [required]
|
||||
**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]
|
||||
**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
|
||||
|
||||
|
||||
@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPostApprovalRequestedIte
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**ApprovalComment** | **String** | A comment left by the approver. | [optional]
|
||||
**ApprovalDecision** | **Enum** [ "APPROVED", "DENIED" ] | The final decision of the approver. | [required]
|
||||
**ApproverName** | **String** | The name of the approver | [required]
|
||||
**Approver** | [**AccessRequestPostApprovalRequestedItemsStatusInnerApprovalInfoInnerApprover**](access-request-post-approval-requested-items-status-inner-approval-info-inner-approver) | | [required]
|
||||
**ApprovalComment** | **String** | Approver's comment. | [optional]
|
||||
**ApprovalDecision** | **Enum** [ "APPROVED", "DENIED" ] | Approver's final decision. | [required]
|
||||
**ApproverName** | **String** | Approver's name. | [required]
|
||||
**Approver** | [**AccessItemApproverDto**](access-item-approver-dto) | Approver's identity. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -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]](#)
|
||||
|
||||
@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPreApproval', 'BetaAcces
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**AccessRequestId** | **String** | The unique ID of the access request. | [required]
|
||||
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required]
|
||||
**RequestedItems** | [**[]AccessRequestPreApprovalRequestedItemsInner**](access-request-pre-approval-requested-items-inner) | Details of the access items being requested. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required]
|
||||
**AccessRequestId** | **String** | Access request's unique ID. | [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 about each requested access item. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,12 +16,12 @@ tags: ['SDK', 'Software Development Kit', 'AccessRequestPreApprovalRequestedItem
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the access item being requested. | [required]
|
||||
**Name** | **String** | The human friendly name of the access item. | [required]
|
||||
**Description** | **String** | Detailed description of the access item. | [optional]
|
||||
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | The type of access item. | [required]
|
||||
**Operation** | **Enum** [ "Add", "Remove" ] | The action to perform on the access item. | [required]
|
||||
**Comment** | **String** | A comment from the identity requesting the access. | [optional]
|
||||
**Id** | **String** | Access item's unique ID. | [required]
|
||||
**Name** | **String** | Access item's name. | [required]
|
||||
**Description** | **String** | Access item's description. | [optional]
|
||||
**Type** | **Enum** [ "ACCESS_PROFILE", "ROLE", "ENTITLEMENT" ] | Access item's type. | [required]
|
||||
**Operation** | **Enum** [ "Add", "Remove" ] | Action to perform on the access item. | [required]
|
||||
**Comment** | **String** | Comment from the identity requesting access. | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**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]
|
||||
**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]
|
||||
|
||||
## Examples
|
||||
|
||||
@@ -17,11 +17,11 @@ tags: ['SDK', 'Software Development Kit', 'AccountAggregationCompleted', 'BetaAc
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Source** | [**AccountAggregationCompletedSource**](account-aggregation-completed-source) | | [required]
|
||||
**Status** | **Enum** [ "Success", "Failed", "Terminated" ] | The overall status of the aggregation. | [required]
|
||||
**Started** | **System.DateTime** | The date and time when the account aggregation started. | [required]
|
||||
**Completed** | **System.DateTime** | The date and time when the account aggregation finished. | [required]
|
||||
**Errors** | **[]String** | A list of errors that occurred during the aggregation. | [required]
|
||||
**Warnings** | **[]String** | A list of warnings that occurred during the aggregation. | [required]
|
||||
**Status** | **Enum** [ "Success", "Failed", "Terminated" ] | Aggregation's overall status. | [required]
|
||||
**Started** | **System.DateTime** | Date and time when the account aggregation started. | [required]
|
||||
**Completed** | **System.DateTime** | Date and time when the account aggregation finished. | [required]
|
||||
**Errors** | **[]String** | List of errors that occurred during the aggregation. | [required]
|
||||
**Warnings** | **[]String** | List of warnings that occurred during the aggregation. | [required]
|
||||
**Stats** | [**AccountAggregationCompletedStats**](account-aggregation-completed-stats) | | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'AccountAggregationCompletedSource', '
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "SOURCE" ] | The DTO type of the source the accounts are being aggregated from. | [required]
|
||||
**Id** | **String** | The ID of the source the accounts are being aggregated from. | [required]
|
||||
**Name** | **String** | Display name of the source the accounts are being aggregated from. | [required]
|
||||
**Type** | **Enum** [ "SOURCE" ] | Source's DTO type. | [required]
|
||||
**Id** | **String** | Source's unique ID. | [required]
|
||||
**Name** | **String** | Source's name. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'AccountAggregationCompletedStats', 'B
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Scanned** | **Int32** | The number of accounts which were scanned / iterated over. | [required]
|
||||
**Unchanged** | **Int32** | The number of accounts which existed before, but had no changes. | [required]
|
||||
**Changed** | **Int32** | The number of accounts which existed before, but had changes. | [required]
|
||||
**Added** | **Int32** | The number of accounts which are new - have not existed before. | [required]
|
||||
**Removed** | **Int32** | The number accounts which existed before, but no longer exist (thus getting removed). | [required]
|
||||
**Scanned** | **Int32** | Number of accounts scanned/iterated over. | [required]
|
||||
**Unchanged** | **Int32** | Number of accounts that existed before but had no changes. | [required]
|
||||
**Changed** | **Int32** | Number of accounts that existed before but had changes. | [required]
|
||||
**Added** | **Int32** | Number of accounts that are new and didn't previously exist. | [required]
|
||||
**Removed** | **Int32** | Number accounts that existed before but were removed and no longer exist. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,15 +16,15 @@ tags: ['SDK', 'Software Development Kit', 'CampaignActivatedCampaign', 'BetaCamp
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | Unique ID for the campaign. | [required]
|
||||
**Name** | **String** | The human friendly name of the campaign. | [required]
|
||||
**Description** | **String** | Extended description of the campaign. | [required]
|
||||
**Created** | **System.DateTime** | The date and time the campaign was created. | [required]
|
||||
**Modified** | **System.DateTime** | The date and time the campaign was last modified. | [optional]
|
||||
**Deadline** | **System.DateTime** | The date and time the campaign is due. | [required]
|
||||
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | The type of campaign. | [required]
|
||||
**Id** | **String** | Campaign's unique ID. | [required]
|
||||
**Name** | **String** | Campaign's name. | [required]
|
||||
**Description** | **String** | Campaign's extended description. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the campaign was created. | [required]
|
||||
**Modified** | **System.DateTime** | Date and time when the campaign was last modified. | [optional]
|
||||
**Deadline** | **System.DateTime** | Date and time when the campaign is due. | [required]
|
||||
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | Campaign's type. | [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
|
||||
|
||||
|
||||
@@ -16,17 +16,17 @@ tags: ['SDK', 'Software Development Kit', 'CampaignActivatedCampaignCampaignOwne
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the identity. | [required]
|
||||
**DisplayName** | **String** | The human friendly name of the identity. | [required]
|
||||
**Email** | **String** | The primary email address of the identity. | [required]
|
||||
**Id** | **String** | Identity's unique ID. | [required]
|
||||
**DisplayName** | **String** | Identity's name. | [required]
|
||||
**Email** | **String** | Identity's primary email address. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
- Prepare the resource
|
||||
```powershell
|
||||
$CampaignActivatedCampaignCampaignOwner = Initialize-PSSailpoint.BetaCampaignActivatedCampaignCampaignOwner -Id 37f080867702c1910177031320c40n27 `
|
||||
-DisplayName John Snow `
|
||||
-Email john.snow@example.com
|
||||
-DisplayName Albert Albertson `
|
||||
-Email albert.albertson@example.com
|
||||
```
|
||||
|
||||
- Convert the resource to JSON
|
||||
|
||||
@@ -16,15 +16,15 @@ tags: ['SDK', 'Software Development Kit', 'CampaignEndedCampaign', 'BetaCampaign
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | Unique ID for the campaign. | [required]
|
||||
**Name** | **String** | The human friendly name of the campaign. | [required]
|
||||
**Description** | **String** | Extended description of the campaign. | [required]
|
||||
**Created** | **System.DateTime** | The date and time the campaign was created. | [required]
|
||||
**Modified** | **System.DateTime** | The date and time the campaign was last modified. | [optional]
|
||||
**Deadline** | **System.DateTime** | The date and time the campaign is due. | [required]
|
||||
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | The type of campaign. | [required]
|
||||
**Id** | **String** | Campaign's unique ID for the campaign. | [required]
|
||||
**Name** | **String** | Campaign's unique ID. | [required]
|
||||
**Description** | **String** | Campaign's extended description. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the campaign was created. | [required]
|
||||
**Modified** | **System.DateTime** | Date and time when the campaign was last modified. | [optional]
|
||||
**Deadline** | **System.DateTime** | Date and time when the campaign is due. | [required]
|
||||
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | Campaign's type. | [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
|
||||
|
||||
|
||||
@@ -16,15 +16,15 @@ tags: ['SDK', 'Software Development Kit', 'CampaignGeneratedCampaign', 'BetaCamp
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the campaign. | [required]
|
||||
**Name** | **String** | Human friendly name of the campaign. | [required]
|
||||
**Description** | **String** | Extended description of the campaign. | [required]
|
||||
**Created** | **System.DateTime** | The date and time the campaign was created. | [required]
|
||||
**Modified** | **String** | The date and time the campaign was last modified. | [optional]
|
||||
**Deadline** | **String** | The date and time when the campaign must be finished by. | [optional]
|
||||
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | The type of campaign that was generated. | [required]
|
||||
**Id** | **String** | Campaign's unique ID. | [required]
|
||||
**Name** | **String** | Campaign's name. | [required]
|
||||
**Description** | **String** | Campaign's extended description. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the campaign was created. | [required]
|
||||
**Modified** | **String** | Date and time when the campaign was last modified. | [optional]
|
||||
**Deadline** | **String** | Date and time when the campaign must be finished. | [optional]
|
||||
**Type** | **Enum** [ "MANAGER", "SOURCE_OWNER", "SEARCH", "ROLE_COMPOSITION" ] | Campaign's type. | [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
|
||||
|
||||
|
||||
@@ -16,17 +16,17 @@ tags: ['SDK', 'Software Development Kit', 'CampaignGeneratedCampaignCampaignOwne
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the identity. | [required]
|
||||
**DisplayName** | **String** | The display name of the identity. | [required]
|
||||
**Email** | **String** | The primary email address of the identity. | [required]
|
||||
**Id** | **String** | Identity's unique ID. | [required]
|
||||
**DisplayName** | **String** | Identity's name. | [required]
|
||||
**Email** | **String** | Identity's primary email address. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
- Prepare the resource
|
||||
```powershell
|
||||
$CampaignGeneratedCampaignCampaignOwner = Initialize-PSSailpoint.BetaCampaignGeneratedCampaignCampaignOwner -Id 37f080867702c1910177031320c40n27 `
|
||||
-DisplayName John Snow `
|
||||
-Email john.snow@example.com
|
||||
-DisplayName Albert Albertson `
|
||||
-Email albert.albertson@example.com
|
||||
```
|
||||
|
||||
- Convert the resource to JSON
|
||||
|
||||
@@ -18,17 +18,17 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**CampaignRef** | [**CampaignReference**](campaign-reference) | | [required]
|
||||
**Phase** | [**CertificationPhase**](certification-phase) | | [required]
|
||||
**Due** | **System.DateTime** | The due date of the certification. | [required]
|
||||
**Signed** | **System.DateTime** | The date the reviewer signed off on the certification. | [required]
|
||||
**Due** | **System.DateTime** | Date and time when the certification is due. | [required]
|
||||
**Signed** | **System.DateTime** | Date and time when the reviewer signed off on the certification. | [required]
|
||||
**Reviewer** | [**Reviewer**](reviewer) | | [required]
|
||||
**Reassignment** | [**Reassignment**](reassignment) | | [optional]
|
||||
**HasErrors** | **Boolean** | Indicates it the certification has any errors. | [required]
|
||||
**ErrorMessage** | **String** | A message indicating what the error is. | [optional]
|
||||
**Completed** | **Boolean** | Indicates if all certification decisions have been made. | [required]
|
||||
**DecisionsMade** | **Int32** | The number of approve/revoke/acknowledge decisions that have been made by the reviewer. | [required]
|
||||
**DecisionsTotal** | **Int32** | The 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]
|
||||
**EntitiesTotal** | **Int32** | The total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required]
|
||||
**HasErrors** | **Boolean** | Indicates whether the certification has any errors. | [required]
|
||||
**ErrorMessage** | **String** | Message indicating what the error is. | [optional]
|
||||
**Completed** | **Boolean** | Indicates whether all certification decisions have been made. | [required]
|
||||
**DecisionsMade** | **Int32** | Number of approve/revoke/acknowledge decisions the reviewer has made. | [required]
|
||||
**DecisionsTotal** | **Int32** | Total number of approve/revoke/acknowledge decisions for the certification. | [required]
|
||||
**EntitiesCompleted** | **Int32** | Number of entities (identities, access profiles, roles, etc.) that are complete and all decisions have been made for. | [required]
|
||||
**EntitiesTotal** | **Int32** | Total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,23 +16,23 @@ tags: ['SDK', 'Software Development Kit', 'CertificationSignedOffCertification',
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | Unique ID of the certification. | [required]
|
||||
**Name** | **String** | The name of the certification. | [required]
|
||||
**Created** | **System.DateTime** | The date and time the certification was created. | [required]
|
||||
**Modified** | **System.DateTime** | The date and time the certification was last modified. | [optional]
|
||||
**Id** | **String** | Certification's unique ID. | [required]
|
||||
**Name** | **String** | Certification's name. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the certification was created. | [required]
|
||||
**Modified** | **System.DateTime** | Date and time when the certification was last modified. | [optional]
|
||||
**CampaignRef** | [**CampaignReference**](campaign-reference) | | [required]
|
||||
**Phase** | [**CertificationPhase**](certification-phase) | | [required]
|
||||
**Due** | **System.DateTime** | The due date of the certification. | [required]
|
||||
**Signed** | **System.DateTime** | The date the reviewer signed off on the certification. | [required]
|
||||
**Due** | **System.DateTime** | Date and time when the certification is due. | [required]
|
||||
**Signed** | **System.DateTime** | Date and time when the reviewer signed off on the certification. | [required]
|
||||
**Reviewer** | [**Reviewer**](reviewer) | | [required]
|
||||
**Reassignment** | [**Reassignment**](reassignment) | | [optional]
|
||||
**HasErrors** | **Boolean** | Indicates it the certification has any errors. | [required]
|
||||
**ErrorMessage** | **String** | A message indicating what the error is. | [optional]
|
||||
**Completed** | **Boolean** | Indicates if all certification decisions have been made. | [required]
|
||||
**DecisionsMade** | **Int32** | The number of approve/revoke/acknowledge decisions that have been made by the reviewer. | [required]
|
||||
**DecisionsTotal** | **Int32** | The 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]
|
||||
**EntitiesTotal** | **Int32** | The total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required]
|
||||
**HasErrors** | **Boolean** | Indicates whether the certification has any errors. | [required]
|
||||
**ErrorMessage** | **String** | Message indicating what the error is. | [optional]
|
||||
**Completed** | **Boolean** | Indicates whether all certification decisions have been made. | [required]
|
||||
**DecisionsMade** | **Int32** | Number of approve/revoke/acknowledge decisions the reviewer has made. | [required]
|
||||
**DecisionsTotal** | **Int32** | Total number of approve/revoke/acknowledge decisions for the certification. | [required]
|
||||
**EntitiesCompleted** | **Int32** | Number of entities (identities, access profiles, roles, etc.) that are complete and all decisions have been made for. | [required]
|
||||
**EntitiesTotal** | **Int32** | Total number of entities (identities, access profiles, roles, etc.) in the certification, both complete and incomplete. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -39,6 +39,7 @@ Name | Type | Description | Notes
|
||||
**SodViolationContext** | [**SodViolationContextCheckCompleted1**](sod-violation-context-check-completed1) | | [optional]
|
||||
**PreApprovalTriggerResult** | [**CompletedApprovalPreApprovalTriggerResult**](completed-approval-pre-approval-trigger-result) | | [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
|
||||
|
||||
@@ -66,7 +67,8 @@ $CompletedApproval = Initialize-PSSailpoint.BetaCompletedApproval -Id 2c9380836
|
||||
-CurrentRemoveDate 2020-07-11T00:00Z `
|
||||
-SodViolationContext null `
|
||||
-PreApprovalTriggerResult null `
|
||||
-ClientMetadata {requestedAppName=test-app, requestedAppId=2c91808f7892918f0178b78da4a305a1}
|
||||
-ClientMetadata {requestedAppName=test-app, requestedAppId=2c91808f7892918f0178b78da4a305a1} `
|
||||
-RequestedAccounts null
|
||||
```
|
||||
|
||||
- Convert the resource to JSON
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Name** | **String** | the name of the rule | [required]
|
||||
**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]
|
||||
**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]
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Name** | **String** | the name of the rule | [required]
|
||||
**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]
|
||||
**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]
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Name** | **String** | the name of the rule | [required]
|
||||
**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]
|
||||
**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]
|
||||
|
||||
@@ -19,6 +19,8 @@ Name | Type | Description | Notes
|
||||
**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]
|
||||
**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
|
||||
|
||||
@@ -26,7 +28,9 @@ Name | Type | Description | Notes
|
||||
```powershell
|
||||
$EventAttributes = Initialize-PSSailpoint.BetaEventAttributes -Id idn:identity-attributes-changed `
|
||||
-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
|
||||
|
||||
@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'FormDefinitionInput', 'BetaFormDefini
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**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]
|
||||
**Description** | **String** | Form input's description. | [optional]
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityAttributesChanged', 'BetaIden
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**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
|
||||
|
||||
|
||||
@@ -16,7 +16,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityAttributesChangedChangesInner
|
||||
|
||||
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]
|
||||
**NewValue** | [**IdentityAttributesChangedChangesInnerNewValue**](identity-attributes-changed-changes-inner-new-value) | | [optional]
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type 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
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityCreated', 'BetaIdentityCreate
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**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
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'IdentityCreatedIdentity', 'BetaIdenti
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | Created identity's DTO type. | [required]
|
||||
**Id** | **String** | Created identity ID. | [required]
|
||||
**Name** | **String** | Created identity's display name. | [required]
|
||||
**Type** | **Enum** [ "IDENTITY" ] | Identity's DTO type. | [required]
|
||||
**Id** | **String** | Identity's unique ID. | [required]
|
||||
**Name** | **String** | Identity's name. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ tags: ['SDK', 'Software Development Kit', 'IdentityDeleted', 'BetaIdentityDelete
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**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
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | Deleted identity's DTO type. | [required]
|
||||
**Id** | **String** | Deleted identity ID. | [required]
|
||||
**Name** | **String** | Deleted identity's display name. | [required]
|
||||
**Name** | **String** | Deleted identity's name. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -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]
|
||||
**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]
|
||||
**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
|
||||
|
||||
@@ -58,7 +60,9 @@ $PendingApproval = Initialize-PSSailpoint.BetaPendingApproval -Id 2c9180835d2e5
|
||||
-RemoveDate 2020-07-11T00:00Z `
|
||||
-RemoveDateUpdateRequested true `
|
||||
-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
|
||||
|
||||
@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompleted', 'BetaProvisio
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**TrackingNumber** | **String** | The reference number of the provisioning request. 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]
|
||||
**Action** | **String** | Origin of where the provisioning request came from. | [optional]
|
||||
**Errors** | **[]String** | A 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]
|
||||
**TrackingNumber** | **String** | Provisioning request's reference number. Useful for tracking status in the 'Account Activity' search interface. | [required]
|
||||
**Sources** | **String** | Sources the provisioning transactions were performed on. Sources are comma separated. | [required]
|
||||
**Action** | **String** | Origin of the provisioning request. | [optional]
|
||||
**Errors** | **[]String** | List of any accumulated error 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]
|
||||
**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
|
||||
|
||||
|
||||
@@ -17,19 +17,19 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompletedAccountRequestsI
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Source** | [**ProvisioningCompletedAccountRequestsInnerSource**](provisioning-completed-account-requests-inner-source) | | [required]
|
||||
**AccountId** | **String** | The unique idenfier of the account being provisioned. | [optional]
|
||||
**AccountOperation** | **String** | The provisioning operation; typically Create, Modify, Enable, Disable, Unlock, or Delete. | [required]
|
||||
**ProvisioningResult** | **Enum** [ "SUCCESS", "PENDING", "FAILED" ] | The overall result of the provisioning transaction; this could be success, pending, failed, etc. | [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]
|
||||
**TicketId** | **String** | A reference to a tracking number, if this is sent to a Service Desk Integration Module (SDIM). | [optional]
|
||||
**AttributeRequests** | [**[]ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner**](provisioning-completed-account-requests-inner-attribute-requests-inner) | A list of attributes as part of the provisioning transaction. | [optional]
|
||||
**AccountId** | **String** | Unique idenfier of the account being provisioned. | [optional]
|
||||
**AccountOperation** | **Enum** [ "Create", "Modify", "Enable", "Disable", "Unlock", "Delete" ] | Provisioning operation. | [required]
|
||||
**ProvisioningResult** | **Enum** [ "SUCCESS", "PENDING", "FAILED" ] | Overall result of the provisioning transaction. | [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** | Reference to a tracking number for if this is sent to a SDIM. | [optional]
|
||||
**AttributeRequests** | [**[]ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner**](provisioning-completed-account-requests-inner-attribute-requests-inner) | List of attributes to include in the provisioning transaction. | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
- Prepare the resource
|
||||
```powershell
|
||||
$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 `
|
||||
-ProvisioningResult SUCCESS `
|
||||
-ProvisioningTarget Corp AD `
|
||||
|
||||
@@ -16,8 +16,8 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompletedAccountRequestsI
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**AttributeName** | **String** | The name of the attribute being provisioned. | [required]
|
||||
**AttributeValue** | **String** | The value of the attribute being provisioned. | [optional]
|
||||
**AttributeName** | **String** | Name of the attribute being provisioned. | [required]
|
||||
**AttributeValue** | **String** | Value of the attribute being provisioned. | [optional]
|
||||
**Operation** | **Enum** [ "Add", "Set", "Remove" ] | The operation to handle the attribute. | [required]
|
||||
|
||||
## Examples
|
||||
@@ -25,7 +25,7 @@ Name | Type | Description | Notes
|
||||
- Prepare the resource
|
||||
```powershell
|
||||
$ProvisioningCompletedAccountRequestsInnerAttributeRequestsInner = Initialize-PSSailpoint.BetaProvisioningCompletedAccountRequestsInnerAttributeRequestsInner -AttributeName memberOf `
|
||||
-AttributeValue CN=jedi,DC=starwars,DC=com `
|
||||
-AttributeValue CN=sales,DC=helpco,DC=com `
|
||||
-Operation Add
|
||||
```
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'ProvisioningCompletedAccountRequestsI
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | ID of the object to which this reference applies | [required]
|
||||
**Type** | **Enum** [ "SOURCE" ] | The type of object that is referenced | [required]
|
||||
**Name** | **String** | Human-readable display name of the object to which this reference applies | [required]
|
||||
**Id** | **String** | Source ID. | [required]
|
||||
**Type** | **Enum** [ "SOURCE" ] | Source DTO type. | [required]
|
||||
**Name** | **String** | Source name. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | Provisioning recipient DTO type. | [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
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | Provisioning requester's DTO type. | [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
|
||||
|
||||
|
||||
@@ -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]](#)
|
||||
|
||||
@@ -41,6 +41,7 @@ Name | Type | Description | Notes
|
||||
**Cancelable** | **Boolean** | True if the request can be canceled. | [optional] [default to $false]
|
||||
**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]
|
||||
**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
|
||||
|
||||
@@ -70,7 +71,8 @@ $RequestedItemStatus = Initialize-PSSailpoint.BetaRequestedItemStatus -Id 2c918
|
||||
-RemoveDate 2019-10-23T00:00Z `
|
||||
-Cancelable true `
|
||||
-AccessRequestId 2b838de9-db9b-abcf-e646-d4f274ad4238 `
|
||||
-ClientMetadata {key1=value1, key2=value2}
|
||||
-ClientMetadata {key1=value1, key2=value2} `
|
||||
-RequestedAccounts null
|
||||
```
|
||||
|
||||
- Convert the resource to JSON
|
||||
|
||||
@@ -16,10 +16,10 @@ tags: ['SDK', 'Software Development Kit', 'Reviewer', 'BetaReviewer']
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY", "GOVERNANCE_GROUP" ] | The reviewer's DTO type. | [required]
|
||||
**Id** | **String** | The reviewer's ID. | [required]
|
||||
**Name** | **String** | The reviewer's display name. | [required]
|
||||
**Email** | **String** | The reviewing identity's email. Only applicable to `IDENTITY`. | [optional]
|
||||
**Type** | **Enum** [ "IDENTITY", "GOVERNANCE_GROUP" ] | Reviewer's DTO type. | [required]
|
||||
**Id** | **String** | Reviewer's ID. | [required]
|
||||
**Name** | **String** | Reviewer's display name. | [required]
|
||||
**Email** | **String** | Reviewing identity's email. This is only applicable to reviewers of the `IDENTITY` type. | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchComplete', 'BetaSavedSearc
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**FileName** | **String** | A name for the report file. | [required]
|
||||
**OwnerEmail** | **String** | The email address of the identity that owns the saved search. | [required]
|
||||
**OwnerName** | **String** | The name of the identity that owns the saved search. | [required]
|
||||
**Query** | **String** | The search query that was used to generate the report. | [required]
|
||||
**SearchName** | **String** | The name of the saved search. | [required]
|
||||
**FileName** | **String** | Report file name. | [required]
|
||||
**OwnerEmail** | **String** | Email address of the identity who owns the saved search. | [required]
|
||||
**OwnerName** | **String** | Name of the identity who owns the saved search. | [required]
|
||||
**Query** | **String** | Search query used to generate the report. | [required]
|
||||
**SearchName** | **String** | Saved search name. | [required]
|
||||
**SearchResults** | [**SavedSearchCompleteSearchResults**](saved-search-complete-search-results) | | [required]
|
||||
**SignedS3Url** | **String** | The Amazon S3 URL to download the report from. | [required]
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchCompleteSearchResultsAccou
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Count** | **String** | The number of rows in the table. | [required]
|
||||
**Noun** | **String** | The type of object represented in the table. | [required]
|
||||
**Preview** | **[]String[]** | A sample of the data in the table. | [required]
|
||||
**Count** | **String** | Number of rows in the table. | [required]
|
||||
**Noun** | **String** | Type of object represented in the table. | [required]
|
||||
**Preview** | **[]String[]** | Sample of table data. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchCompleteSearchResultsEntit
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Count** | **String** | The number of rows in the table. | [required]
|
||||
**Noun** | **String** | The type of object represented in the table. | [required]
|
||||
**Preview** | **[]String[]** | A sample of the data in the table. | [required]
|
||||
**Count** | **String** | Number of rows in the table. | [required]
|
||||
**Noun** | **String** | Type of object represented in the table. | [required]
|
||||
**Preview** | **[]String[]** | Sample of table data. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SavedSearchCompleteSearchResultsIdent
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Count** | **String** | The number of rows in the table. | [required]
|
||||
**Noun** | **String** | The type of object represented in the table. | [required]
|
||||
**Preview** | **[]String[]** | A sample of the data in the table. | [required]
|
||||
**Count** | **String** | Number of rows in the table. | [required]
|
||||
**Noun** | **String** | Type of object represented in the table. | [required]
|
||||
**Preview** | **[]String[]** | Sample of the table data. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -18,19 +18,21 @@ Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Frequency** | **Enum** [ "daily", "weekly", "monthly", "yearly", "cronSchedule" ] | Frequency of execution | [required]
|
||||
**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]
|
||||
**WeeklyTimes** | **[]String** | Scheduled execution times | [optional]
|
||||
**YearlyTimes** | **[]String** | Scheduled execution times | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
- Prepare the resource
|
||||
```powershell
|
||||
$ScheduledAttributes = Initialize-PSSailpoint.BetaScheduledAttributes -Frequency null `
|
||||
$ScheduledAttributes = Initialize-PSSailpoint.BetaScheduledAttributes -Frequency daily `
|
||||
-TimeZone America/Chicago `
|
||||
-CronString 0 9 * * 1 `
|
||||
-WeeklyDays Monday `
|
||||
-WeeklyTimes Monday
|
||||
-WeeklyTimes Monday `
|
||||
-YearlyTimes 1969-12-31T09:00:00.000Z
|
||||
```
|
||||
|
||||
- Convert the resource to JSON
|
||||
|
||||
@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'SourceAccountCreated', 'BetaSourceAcc
|
||||
|
||||
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]
|
||||
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required]
|
||||
**SourceId** | **String** | The ID of the source. | [required]
|
||||
**SourceName** | **String** | The name of the source. | [required]
|
||||
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required]
|
||||
**IdentityName** | **String** | The name of the identity that is correlated with this 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]
|
||||
**NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
|
||||
**SourceId** | **String** | Source ID. | [required]
|
||||
**SourceName** | **String** | Source name. | [required]
|
||||
**IdentityId** | **String** | ID of the identity correlated with the 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 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'SourceAccountDeleted', 'BetaSourceAcc
|
||||
|
||||
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]
|
||||
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required]
|
||||
**SourceId** | **String** | The ID of the source. | [required]
|
||||
**SourceName** | **String** | The name of the source. | [required]
|
||||
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required]
|
||||
**IdentityName** | **String** | The name of the identity that is correlated with this 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]
|
||||
**NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
|
||||
**SourceId** | **String** | Source ID. | [required]
|
||||
**SourceName** | **String** | Source name. | [required]
|
||||
**IdentityId** | **String** | ID of the identity correlated with the 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 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,14 +16,14 @@ tags: ['SDK', 'Software Development Kit', 'SourceAccountUpdated', 'BetaSourceAcc
|
||||
|
||||
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]
|
||||
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required]
|
||||
**SourceId** | **String** | The ID of the source. | [required]
|
||||
**SourceName** | **String** | The name of the source. | [required]
|
||||
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required]
|
||||
**IdentityName** | **String** | The name of the identity that is correlated with this 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]
|
||||
**NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
|
||||
**SourceId** | **String** | Source ID. | [required]
|
||||
**SourceName** | **String** | Source name. | [required]
|
||||
**IdentityId** | **String** | ID of the identity correlated with the 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 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SourceCreated', 'BetaSourceCreated']
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the source. | [required]
|
||||
**Name** | **String** | Human friendly name of the source. | [required]
|
||||
**Type** | **String** | The connection type. | [required]
|
||||
**Created** | **System.DateTime** | The date and time the source was created. | [required]
|
||||
**Connector** | **String** | The connector type used to connect to the source. | [required]
|
||||
**Id** | **String** | Source's unique ID. | [required]
|
||||
**Name** | **String** | Source name. | [required]
|
||||
**Type** | **String** | Connection type. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the source was created. | [required]
|
||||
**Connector** | **String** | Connector type used to connect to the source. | [required]
|
||||
**Actor** | [**SourceCreatedActor**](source-created-actor) | | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SourceCreatedActor', 'BetaSourceCreat
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who created the source. | [required]
|
||||
**Id** | **String** | ID of identity who created the source. | [required]
|
||||
**Name** | **String** | Display name of identity who created the source. | [required]
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who created the source. | [required]
|
||||
**Id** | **String** | ID of the identity who created the source. | [required]
|
||||
**Name** | **String** | Name of the identity who created the source. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SourceDeleted', 'BetaSourceDeleted']
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the source. | [required]
|
||||
**Name** | **String** | Human friendly name of the source. | [required]
|
||||
**Type** | **String** | The connection type. | [required]
|
||||
**Deleted** | **System.DateTime** | The date and time the source was deleted. | [required]
|
||||
**Connector** | **String** | The connector type used to connect to the source. | [required]
|
||||
**Id** | **String** | Source's unique ID. | [required]
|
||||
**Name** | **String** | Source name. | [required]
|
||||
**Type** | **String** | Connection type. | [required]
|
||||
**Deleted** | **System.DateTime** | Date and time when the source was deleted. | [required]
|
||||
**Connector** | **String** | Connector type used to connect to the source. | [required]
|
||||
**Actor** | [**SourceDeletedActor**](source-deleted-actor) | | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SourceDeletedActor', 'BetaSourceDelet
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who deleted the source. | [required]
|
||||
**Id** | **String** | ID of identity who deleted the source. | [required]
|
||||
**Name** | **String** | Display name of identity who deleted the source. | [required]
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who deleted the source. | [required]
|
||||
**Id** | **String** | ID of the identity who deleted the source. | [required]
|
||||
**Name** | **String** | Name of the identity who deleted the source. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ tags: ['SDK', 'Software Development Kit', 'SourceUpdated', 'BetaSourceUpdated']
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The unique ID of the source. | [required]
|
||||
**Name** | **String** | The user friendly name of the source. | [required]
|
||||
**Type** | **String** | The connection type of the source. | [required]
|
||||
**Modified** | **System.DateTime** | The date and time the source was modified. | [required]
|
||||
**Connector** | **String** | The connector type used to connect to the source. | [required]
|
||||
**Id** | **String** | Source's unique ID. | [required]
|
||||
**Name** | **String** | Source name. | [required]
|
||||
**Type** | **String** | Connection type. | [required]
|
||||
**Modified** | **System.DateTime** | Date and time when the source was modified. | [required]
|
||||
**Connector** | **String** | Connector type used to connect to the source. | [required]
|
||||
**Actor** | [**SourceUpdatedActor**](source-updated-actor) | | [required]
|
||||
|
||||
## Examples
|
||||
@@ -28,7 +28,7 @@ Name | Type | Description | Notes
|
||||
- Prepare the resource
|
||||
```powershell
|
||||
$SourceUpdated = Initialize-PSSailpoint.BetaSourceUpdated -Id 2c9180866166b5b0016167c32ef31a66 `
|
||||
-Name Corporate Active Directory `
|
||||
-Name Test source `
|
||||
-Type DIRECT_CONNECT `
|
||||
-Modified 2021-03-29T22:01:50.474Z `
|
||||
-Connector active-directory `
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'SourceUpdatedActor', 'BetaSourceUpdat
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of identity who updated the source. | [required]
|
||||
**Id** | **String** | ID of identity who updated the source. | [optional]
|
||||
**Name** | **String** | Display name of identity who updated the source. | [required]
|
||||
**Type** | **Enum** [ "IDENTITY" ] | DTO type of the identity who updated the source. | [required]
|
||||
**Id** | **String** | ID of the identity who updated the source. | [required]
|
||||
**Name** | **String** | Name of the identity who updated the source. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -32,7 +32,7 @@ $TaskDefinitionSummary = Initialize-PSSailpoint.BetaTaskDefinitionSummary -Id 2
|
||||
-Description Aggregates from the specified application. `
|
||||
-ParentName Cloud Account Aggregation `
|
||||
-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
|
||||
|
||||
@@ -16,52 +16,52 @@ tags: ['SDK', 'Software Development Kit', 'TriggerExampleInput', 'BetaTriggerExa
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**AccessRequestId** | **String** | The unique ID of the access request. | [required]
|
||||
**RequestedFor** | [**[]AccessItemRequestedForDto**](access-item-requested-for-dto) | Identities access was requested for. | [required]
|
||||
**RequestedItems** | [**[]AccessRequestPreApprovalRequestedItemsInner**](access-request-pre-approval-requested-items-inner) | Details of the access items being requested. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto**](access-item-requester-dto) | | [required]
|
||||
**RequestedItemsStatus** | [**[]AccessRequestPostApprovalRequestedItemsStatusInner**](access-request-post-approval-requested-items-status-inner) | Details on the outcome of each access item. | [required]
|
||||
**AccessRequestId** | **String** | Access request's unique ID. | [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 about each requested access item. | [required]
|
||||
**RequestedBy** | [**AccessItemRequesterDto1**](access-item-requester-dto1) | | [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]
|
||||
**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]
|
||||
**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]
|
||||
**Warnings** | **[]String** | A list of any accumulated warning messages that occurred during provisioning. | [required]
|
||||
**Errors** | **[]String** | List of any accumulated error 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]
|
||||
**Identity** | [**IdentityDeletedIdentity**](identity-deleted-identity) | | [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]
|
||||
**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]
|
||||
**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 | Account attributes. The attributes' contents depend on the source's account schema. | [required]
|
||||
**EntitlementCount** | **Int32** | The number of entitlements associated with this account. | [optional]
|
||||
**Campaign** | [**CampaignGeneratedCampaign**](campaign-generated-campaign) | | [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]
|
||||
**Sources** | **String** | One or more sources that the provisioning transaction(s) were done against. Sources are comma separated. | [required]
|
||||
**Action** | **String** | Origin of where the provisioning request came from. | [optional]
|
||||
**TrackingNumber** | **String** | Provisioning request's reference number. Useful for tracking status in the 'Account Activity' search interface. | [required]
|
||||
**Sources** | **String** | Sources the provisioning transactions were performed on. Sources are comma separated. | [required]
|
||||
**Action** | **String** | Origin of the provisioning request. | [optional]
|
||||
**Recipient** | [**ProvisioningCompletedRecipient**](provisioning-completed-recipient) | | [required]
|
||||
**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]
|
||||
**FileName** | **String** | A name for the report file. | [required]
|
||||
**OwnerEmail** | **String** | The email address of the identity that owns the saved search. | [required]
|
||||
**OwnerName** | **String** | The name of the identity that owns the saved search. | [required]
|
||||
**Query** | **String** | The search query that was used to generate the report. | [required]
|
||||
**SearchName** | **String** | The name of the saved search. | [required]
|
||||
**AccountRequests** | [**[]ProvisioningCompletedAccountRequestsInner**](provisioning-completed-account-requests-inner) | List of provisioning instructions to perform on an account-by-account basis. | [required]
|
||||
**FileName** | **String** | Report file name. | [required]
|
||||
**OwnerEmail** | **String** | Email address of the identity who owns the saved search. | [required]
|
||||
**OwnerName** | **String** | Name of the identity who owns the saved search. | [required]
|
||||
**Query** | **String** | Search query used to generate the report. | [required]
|
||||
**SearchName** | **String** | Saved search name. | [required]
|
||||
**SearchResults** | [**SavedSearchCompleteSearchResults**](saved-search-complete-search-results) | | [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]
|
||||
**Id** | **String** | The unique ID of the source. | [required]
|
||||
**NativeIdentifier** | **String** | Unique ID of the account on the source. | [required]
|
||||
**SourceId** | **String** | The ID of the source. | [required]
|
||||
**SourceName** | **String** | The name of the source. | [required]
|
||||
**IdentityId** | **String** | The ID of the identity that is correlated with this account. | [required]
|
||||
**IdentityName** | **String** | The name of the identity that is correlated with this account. | [required]
|
||||
**Name** | **String** | The user friendly name of the source. | [required]
|
||||
**Type** | **String** | The connection type of the source. | [required]
|
||||
**Created** | **System.DateTime** | The date and time the status change occurred. | [required]
|
||||
**Connector** | **String** | The connector type used to connect to the source. | [required]
|
||||
**Uuid** | **String** | Identity's universal unique identifier (UUID) on the source. The source system generates the UUID. | [required]
|
||||
**Id** | **String** | Source's unique ID. | [required]
|
||||
**NativeIdentifier** | **String** | Account's unique ID on the source. | [required]
|
||||
**SourceId** | **String** | Source ID. | [required]
|
||||
**SourceName** | **String** | Source name. | [required]
|
||||
**IdentityId** | **String** | ID of the identity correlated with the account. | [required]
|
||||
**IdentityName** | **String** | Name of the identity correlated with the account. | [required]
|
||||
**Name** | **String** | Source name. | [required]
|
||||
**Type** | **String** | Connection type. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the status change occurred. | [required]
|
||||
**Connector** | **String** | Connector type used to connect to the source. | [required]
|
||||
**Actor** | [**SourceUpdatedActor**](source-updated-actor) | | [required]
|
||||
**Deleted** | **System.DateTime** | The date and time the source was deleted. | [required]
|
||||
**Modified** | **System.DateTime** | The date and time the source was modified. | [required]
|
||||
**Deleted** | **System.DateTime** | Date and time when the source was deleted. | [required]
|
||||
**Modified** | **System.DateTime** | Date and time when the source was modified. | [required]
|
||||
**Application** | [**VAClusterStatusChangeEventApplication**](va-cluster-status-change-event-application) | | [required]
|
||||
**HealthCheckResult** | [**VAClusterStatusChangeEventHealthCheckResult**](va-cluster-status-change-event-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 `
|
||||
-IdentityId ee769173319b41d19ccec6c235423237b `
|
||||
-IdentityName john.doe `
|
||||
-Name Corporate Active Directory `
|
||||
-Name Test source `
|
||||
-Type DIRECT_CONNECT `
|
||||
-Created 2020-06-29T22:01:50.474Z `
|
||||
-Connector active-directory `
|
||||
|
||||
@@ -16,8 +16,8 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEvent', 'BetaVAC
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Created** | **System.DateTime** | The date and time the status change occurred. | [required]
|
||||
**Type** | **Enum** [ "SOURCE", "CLUSTER" ] | The type of the object that initiated this event. | [required]
|
||||
**Created** | **System.DateTime** | Date and time when the status change occurred. | [required]
|
||||
**Type** | **Enum** [ "SOURCE", "CLUSTER" ] | Type of the object that initiated the event. | [required]
|
||||
**Application** | [**VAClusterStatusChangeEventApplication**](va-cluster-status-change-event-application) | | [required]
|
||||
**HealthCheckResult** | [**VAClusterStatusChangeEventHealthCheckResult**](va-cluster-status-change-event-health-check-result) | | [required]
|
||||
**PreviousHealthCheckResult** | [**VAClusterStatusChangeEventPreviousHealthCheckResult**](va-cluster-status-change-event-previous-health-check-result) | | [required]
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEventApplication
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Id** | **String** | The GUID of the application | [required]
|
||||
**Name** | **String** | The name of the application | [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]
|
||||
**Id** | **String** | Application's globally unique identifier (GUID). | [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. Attributes only populate if the type is `SOURCE` and the source has a proxy. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEventHealthCheck
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Message** | **String** | Detailed message of the result of the health check. | [required]
|
||||
**ResultType** | **String** | The type of the health check result. | [required]
|
||||
**Status** | **Enum** [ "Succeeded", "Failed" ] | The status of the health check. | [required]
|
||||
**Message** | **String** | Detailed message of the health check result.. | [required]
|
||||
**ResultType** | **String** | Health check result type. | [required]
|
||||
**Status** | **Enum** [ "Succeeded", "Failed" ] | Health check status. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ tags: ['SDK', 'Software Development Kit', 'VAClusterStatusChangeEventPreviousHea
|
||||
|
||||
Name | Type | Description | Notes
|
||||
------------ | ------------- | ------------- | -------------
|
||||
**Message** | **String** | Detailed message of the result of the health check. | [required]
|
||||
**ResultType** | **String** | The type of the health check result. | [required]
|
||||
**Status** | **Enum** [ "Succeeded", "Failed" ] | The status of the health check. | [required]
|
||||
**Message** | **String** | Detailed message of the health check result. | [required]
|
||||
**ResultType** | **String** | Health check result type. | [required]
|
||||
**Status** | **Enum** [ "Succeeded", "Failed" ] | Health check status. | [required]
|
||||
|
||||
## Examples
|
||||
|
||||
|
||||
@@ -19,14 +19,17 @@ Name | Type | Description | Notes
|
||||
**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]
|
||||
**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]
|
||||
**ClientId** | **String** | OAuth Client ID to authenticate with this trigger | [optional]
|
||||
**Url** | **String** | URL to invoke this workflow | [optional]
|
||||
**Frequency** | **Enum** [ "daily", "weekly", "monthly", "yearly", "cronSchedule" ] | Frequency of execution | [required]
|
||||
**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]
|
||||
**WeeklyTimes** | **[]String** | Scheduled execution times | [optional]
|
||||
**YearlyTimes** | **[]String** | Scheduled execution times | [optional]
|
||||
|
||||
## Examples
|
||||
|
||||
@@ -35,14 +38,17 @@ Name | Type | Description | Notes
|
||||
$WorkflowTriggerAttributes = Initialize-PSSailpoint.BetaWorkflowTriggerAttributes -Id idn:identity-attributes-changed `
|
||||
-VarFilter $.changes[?(@.attribute == 'manager')] `
|
||||
-Description Run a search and notify the results `
|
||||
-AttributeToFilter LifecycleState `
|
||||
-FormDefinitionId Admin_Access_Request_Form `
|
||||
-Name search-and-notify `
|
||||
-ClientId 87e239b2-b85b-4bde-b9a7-55bf304ddcdc `
|
||||
-Url https://tenant.api.identitynow.com/beta/workflows/execute/external/c79e0079-562c-4df5-aa73-60a9e25c916d `
|
||||
-Frequency null `
|
||||
-Frequency daily `
|
||||
-TimeZone America/Chicago `
|
||||
-CronString 0 9 * * 1 `
|
||||
-WeeklyDays Monday `
|
||||
-WeeklyTimes Monday
|
||||
-WeeklyTimes Monday `
|
||||
-YearlyTimes 1969-12-31T09:00:00.000Z
|
||||
```
|
||||
|
||||
- Convert the resource to JSON
|
||||
|
||||
@@ -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 'AD Developers' 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.
|
||||
|
||||
@@ -62,7 +62,7 @@ Method | HTTP request | Description
|
||||
|
||||
|
||||
## 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.
|
||||
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]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
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 | 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 | 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 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 | 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 | 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 | 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 | 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.
|
||||
|
||||
### Return type
|
||||
[**AccessProfile[]**](../models/access-profile)
|
||||
@@ -435,14 +435,14 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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)
|
||||
$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)
|
||||
$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 = 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)
|
||||
$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)
|
||||
$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)
|
||||
$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)
|
||||
$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)
|
||||
|
||||
# List Access Profiles
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ tags: ['SDK', 'Software Development Kit', 'Approvals', 'V2024Approvals']
|
||||
# Approvals
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -31,10 +31,12 @@ Method | HTTP request | Description
|
||||
[**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-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
|
||||
[**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-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
|
||||
[**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
|
||||
@@ -42,8 +44,10 @@ Method | HTTP request | Description
|
||||
[**Get-V2024Backups**](#list-backups) | **GET** `/configuration-hub/backups` | List Backups
|
||||
[**Get-V2024Deploys**](#list-deploys) | **GET** `/configuration-hub/deploys` | List Deploys
|
||||
[**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
|
||||
[**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
|
||||
@@ -218,6 +222,74 @@ try {
|
||||
```
|
||||
[[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'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
|
||||
This API uploads a JSON configuration file into a tenant.
|
||||
|
||||
@@ -420,6 +492,52 @@ try {
|
||||
```
|
||||
[[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'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
|
||||
This API deletes an uploaded configuration based on Id.
|
||||
|
||||
@@ -744,6 +862,49 @@ try {
|
||||
```
|
||||
[[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'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
|
||||
This API gets a list of existing uploaded configurations for the current tenant.
|
||||
|
||||
@@ -854,3 +1015,62 @@ try {
|
||||
}
|
||||
```
|
||||
[[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'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]](#)
|
||||
|
||||
@@ -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'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'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'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'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'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'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]](#)
|
||||
@@ -33,9 +33,6 @@ Method | HTTP request | Description
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
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.
|
||||
|
||||
### Return type
|
||||
@@ -65,7 +61,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
$ConnectorRuleCreateRequest = @"{
|
||||
"sourceCode" : {
|
||||
"version" : "1.0",
|
||||
@@ -97,10 +92,10 @@ $ConnectorRuleCreateRequest = @"{
|
||||
|
||||
try {
|
||||
$Result = ConvertFrom-JsonToConnectorRuleCreateRequest -Json $ConnectorRuleCreateRequest
|
||||
New-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -ConnectorRuleCreateRequest $Result
|
||||
New-V2024ConnectorRule -ConnectorRuleCreateRequest $Result
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# New-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -ConnectorRuleCreateRequest $Result
|
||||
# New-V2024ConnectorRule -ConnectorRuleCreateRequest $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024ConnectorRule"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -109,9 +104,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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
|
||||
(empty response body)
|
||||
@@ -143,15 +134,14 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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
|
||||
|
||||
try {
|
||||
Remove-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental
|
||||
Remove-V2024ConnectorRule -Id $Id
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Remove-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental
|
||||
# Remove-V2024ConnectorRule -Id $Id
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024ConnectorRule"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -160,9 +150,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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
|
||||
[**ConnectorRuleResponse**](../models/connector-rule-response)
|
||||
@@ -194,15 +180,14 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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
|
||||
|
||||
try {
|
||||
Get-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental
|
||||
Get-V2024ConnectorRule -Id $Id
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Get-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental
|
||||
# Get-V2024ConnectorRule -Id $Id
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorRule"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -211,9 +196,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/v2024/get-connector-rule-list)
|
||||
@@ -221,7 +203,6 @@ List existing connector rules.
|
||||
### Parameters
|
||||
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 | 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.
|
||||
@@ -245,7 +226,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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)
|
||||
$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)
|
||||
@@ -253,10 +233,10 @@ $Count = $true # Boolean | If *true* it will populate the *X-Total-Count* respon
|
||||
# List Connector Rules
|
||||
|
||||
try {
|
||||
Get-V2024ConnectorRuleList -XSailPointExperimental $XSailPointExperimental
|
||||
Get-V2024ConnectorRuleList
|
||||
|
||||
# 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 {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024ConnectorRuleList"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -265,9 +245,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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`
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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.
|
||||
|
||||
### Return type
|
||||
@@ -300,7 +276,6 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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 = @"{
|
||||
"sourceCode" : {
|
||||
"version" : "1.0",
|
||||
@@ -332,10 +307,10 @@ $ConnectorRuleUpdateRequest = @"{
|
||||
# Update Connector Rule
|
||||
|
||||
try {
|
||||
Send-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental
|
||||
Send-V2024ConnectorRule -Id $Id
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Send-V2024ConnectorRule -Id $Id -XSailPointExperimental $XSailPointExperimental -ConnectorRuleUpdateRequest $Result
|
||||
# Send-V2024ConnectorRule -Id $Id -ConnectorRuleUpdateRequest $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Send-V2024ConnectorRule"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -344,9 +319,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
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.
|
||||
|
||||
### Return type
|
||||
@@ -376,7 +347,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
$SourceCode = @"{
|
||||
"version" : "1.0",
|
||||
"script" : "return \"Mr. \" + firstName;"
|
||||
@@ -386,10 +356,10 @@ $SourceCode = @"{
|
||||
|
||||
try {
|
||||
$Result = ConvertFrom-JsonToSourceCode -Json $SourceCode
|
||||
Test-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -SourceCode $Result
|
||||
Test-V2024ConnectorRule -SourceCode $Result
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Test-V2024ConnectorRule -XSailPointExperimental $XSailPointExperimental -SourceCode $Result
|
||||
# Test-V2024ConnectorRule -SourceCode $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Test-V2024ConnectorRule"
|
||||
Write-Host $_.ErrorDetails
|
||||
|
||||
@@ -46,9 +46,6 @@ Method | HTTP request | Description
|
||||
|
||||
|
||||
## 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)
|
||||
@@ -56,7 +53,6 @@ This API is currently in an experimental state. The API is subject to change bas
|
||||
### Parameters
|
||||
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
|
||||
|
||||
### Return type
|
||||
@@ -78,7 +74,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
$Body = @"{
|
||||
"owner" : {
|
||||
"name" : "Grant Smith",
|
||||
@@ -194,10 +189,10 @@ $Body = @"{
|
||||
# Creates a form definition.
|
||||
|
||||
try {
|
||||
New-V2024FormDefinition -XSailPointExperimental $XSailPointExperimental
|
||||
New-V2024FormDefinition
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# New-V2024FormDefinition -XSailPointExperimental $XSailPointExperimental -Body $Result
|
||||
# New-V2024FormDefinition -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinition"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -206,9 +201,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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)
|
||||
@@ -216,7 +208,6 @@ This API is currently in an experimental state. The API is subject to change bas
|
||||
### Parameters
|
||||
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
|
||||
|
||||
### Return type
|
||||
@@ -239,7 +230,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
$Body = @"{
|
||||
"description" : "A description",
|
||||
"attributes" : {
|
||||
@@ -253,10 +243,10 @@ $Body = @"{
|
||||
# Generate JSON Schema dynamically.
|
||||
|
||||
try {
|
||||
New-V2024FormDefinitionDynamicSchema -XSailPointExperimental $XSailPointExperimental
|
||||
New-V2024FormDefinitionDynamicSchema
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# New-V2024FormDefinitionDynamicSchema -XSailPointExperimental $XSailPointExperimental -Body $Result
|
||||
# New-V2024FormDefinitionDynamicSchema -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinitionDynamicSchema"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -265,9 +255,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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
|
||||
|
||||
### Return type
|
||||
@@ -303,16 +289,15 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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
|
||||
|
||||
# Upload new form definition file.
|
||||
|
||||
try {
|
||||
New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -File $File
|
||||
New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -File $File
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -File $File
|
||||
# New-V2024FormDefinitionFileRequest -FormDefinitionID $FormDefinitionID -File $File
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormDefinitionFileRequest"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -321,9 +306,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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)
|
||||
@@ -331,7 +313,6 @@ This API is currently in an experimental state. The API is subject to change bas
|
||||
### Parameters
|
||||
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
|
||||
|
||||
### Return type
|
||||
@@ -353,7 +334,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
$Body = @"{
|
||||
"formInput" : {
|
||||
"input1" : "Sales"
|
||||
@@ -379,10 +359,10 @@ $Body = @"{
|
||||
# Creates a form instance.
|
||||
|
||||
try {
|
||||
New-V2024FormInstance -XSailPointExperimental $XSailPointExperimental
|
||||
New-V2024FormInstance
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# New-V2024FormInstance -XSailPointExperimental $XSailPointExperimental -Body $Result
|
||||
# New-V2024FormInstance -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling New-V2024FormInstance"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -391,9 +371,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
Path | FormDefinitionID | **String** | True | Form definition ID
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
[**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
|
||||
```powershell
|
||||
$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.
|
||||
|
||||
try {
|
||||
Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental
|
||||
Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental
|
||||
# Remove-V2024FormDefinition -FormDefinitionID $FormDefinitionID
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Remove-V2024FormDefinition"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -442,9 +417,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/v2024/export-form-definitions-by-tenant)
|
||||
@@ -452,7 +424,6 @@ No parameters required.
|
||||
### Parameters
|
||||
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 | 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*
|
||||
@@ -477,7 +448,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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)
|
||||
$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)
|
||||
@@ -486,10 +456,10 @@ $Sorters = "name" # String | Sort results using the standard syntax described in
|
||||
# List form definitions by tenant.
|
||||
|
||||
try {
|
||||
Export-V2024FormDefinitionsByTenant -XSailPointExperimental $XSailPointExperimental
|
||||
Export-V2024FormDefinitionsByTenant
|
||||
|
||||
# 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 {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Export-V2024FormDefinitionsByTenant"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -498,9 +468,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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)
|
||||
@@ -510,7 +477,6 @@ Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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.
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
**System.IO.FileInfo**
|
||||
@@ -535,15 +501,14 @@ Code | Description | Data Type
|
||||
```powershell
|
||||
$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.
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
|
||||
# Download definition file by fileId.
|
||||
|
||||
try {
|
||||
Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID -XSailPointExperimental $XSailPointExperimental
|
||||
Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID -XSailPointExperimental $XSailPointExperimental
|
||||
# Get-V2024FileFromS3 -FormDefinitionID $FormDefinitionID -FileID $FileID
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FileFromS3"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -552,9 +517,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
Path | FormDefinitionID | **String** | True | Form definition ID
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
[**FormDefinitionResponse**](../models/form-definition-response)
|
||||
@@ -586,15 +547,14 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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.
|
||||
|
||||
try {
|
||||
Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental
|
||||
Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental
|
||||
# Get-V2024FormDefinitionByKey -FormDefinitionID $FormDefinitionID
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormDefinitionByKey"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -603,9 +563,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
Path | FormInstanceID | **String** | True | Form instance ID
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
[**FormInstanceResponse**](../models/form-instance-response)
|
||||
@@ -637,15 +593,14 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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.
|
||||
|
||||
try {
|
||||
Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental
|
||||
Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental
|
||||
# Get-V2024FormInstanceByKey -FormInstanceID $FormInstanceID
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormInstanceByKey"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -654,9 +609,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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)
|
||||
@@ -666,7 +618,6 @@ Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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.
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
**System.IO.FileInfo**
|
||||
@@ -691,15 +642,14 @@ Code | Description | Data Type
|
||||
```powershell
|
||||
$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.
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
|
||||
# Download instance file by fileId.
|
||||
|
||||
try {
|
||||
Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID -XSailPointExperimental $XSailPointExperimental
|
||||
Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID -XSailPointExperimental $XSailPointExperimental
|
||||
# Get-V2024FormInstanceFile -FormInstanceID $FormInstanceID -FileID $FileID
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-V2024FormInstanceFile"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -708,9 +658,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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)
|
||||
@@ -718,8 +665,7 @@ This API is currently in an experimental state. The API is subject to change bas
|
||||
### Parameters
|
||||
Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
Body | Body | [**[]ExportFormDefinitionsByTenant200ResponseInner**](../models/export-form-definitions-by-tenant200-response-inner) | (optional) | Body is the request payload to import form definitions
|
||||
Body | Body | [**[]ImportFormDefinitionsRequestInner**](../models/import-form-definitions-request-inner) | (optional) | Body is the request payload to import form definitions
|
||||
|
||||
### Return type
|
||||
[**ImportFormDefinitions202Response**](../models/import-form-definitions202-response)
|
||||
@@ -740,23 +686,22 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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.
|
||||
|
||||
try {
|
||||
Import-V2024FormDefinitions -XSailPointExperimental $XSailPointExperimental
|
||||
Import-V2024FormDefinitions
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Import-V2024FormDefinitions -XSailPointExperimental $XSailPointExperimental -Body $Result
|
||||
# Import-V2024FormDefinitions -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Import-V2024FormDefinitions"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -765,9 +710,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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
|
||||
|
||||
### Return type
|
||||
@@ -800,7 +741,6 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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 = @"[{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.
|
||||
|
||||
try {
|
||||
Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental
|
||||
Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental -Body $Result
|
||||
# Update-V2024FormDefinition -FormDefinitionID $FormDefinitionID -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024FormDefinition"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -820,9 +760,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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
|
||||
|
||||
### Return type
|
||||
@@ -856,7 +792,6 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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 = @"[{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.
|
||||
|
||||
try {
|
||||
Update-V2024FormInstance -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental
|
||||
Update-V2024FormInstance -FormInstanceID $FormInstanceID
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Update-V2024FormInstance -FormInstanceID $FormInstanceID -XSailPointExperimental $XSailPointExperimental -Body $Result
|
||||
# Update-V2024FormInstance -FormInstanceID $FormInstanceID -Body $Result
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Update-V2024FormInstance"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -876,9 +811,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/v2024/search-form-definitions-by-tenant)
|
||||
@@ -886,7 +818,6 @@ No parameters required.
|
||||
### Parameters
|
||||
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 | 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*
|
||||
@@ -911,7 +842,6 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```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)
|
||||
$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)
|
||||
@@ -920,10 +850,10 @@ $Sorters = "name" # String | Sort results using the standard syntax described in
|
||||
# Export form definitions by tenant.
|
||||
|
||||
try {
|
||||
Search-V2024FormDefinitionsByTenant -XSailPointExperimental $XSailPointExperimental
|
||||
Search-V2024FormDefinitionsByTenant
|
||||
|
||||
# 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 {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormDefinitionsByTenant"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -932,9 +862,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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 `{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 | 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 | 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.
|
||||
@@ -972,7 +898,6 @@ Code | Description | Data Type
|
||||
```powershell
|
||||
$FormInstanceID = "00000000-0000-0000-0000-000000000000" # String | Form instance 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)
|
||||
$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)
|
||||
@@ -980,10 +905,10 @@ $Query = "support" # String | String that is passed to the underlying API to fil
|
||||
# Retrieves dynamic data by element.
|
||||
|
||||
try {
|
||||
Search-V2024FormElementDataByElementID -FormInstanceID $FormInstanceID -FormElementID $FormElementID -XSailPointExperimental $XSailPointExperimental
|
||||
Search-V2024FormElementDataByElementID -FormInstanceID $FormInstanceID -FormElementID $FormElementID
|
||||
|
||||
# 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 {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormElementDataByElementID"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -992,9 +917,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/v2024/search-form-instances-by-tenant)
|
||||
@@ -1002,7 +924,6 @@ No parameters required.
|
||||
### Parameters
|
||||
Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
[**ListFormInstancesByTenantResponse[]**](../models/list-form-instances-by-tenant-response)
|
||||
@@ -1023,15 +944,14 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
|
||||
# List form instances by tenant.
|
||||
|
||||
try {
|
||||
Search-V2024FormInstancesByTenant -XSailPointExperimental $XSailPointExperimental
|
||||
Search-V2024FormInstancesByTenant
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Search-V2024FormInstancesByTenant -XSailPointExperimental $XSailPointExperimental
|
||||
# Search-V2024FormInstancesByTenant
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024FormInstancesByTenant"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -1040,9 +960,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/v2024/search-pre-defined-select-options)
|
||||
@@ -1050,7 +967,6 @@ No parameters required.
|
||||
### Parameters
|
||||
Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
| XSailPointExperimental | **String** | True (default to "true") | Use this header to enable this experimental API.
|
||||
|
||||
### Return type
|
||||
[**ListPredefinedSelectOptionsResponse**](../models/list-predefined-select-options-response)
|
||||
@@ -1071,15 +987,14 @@ Code | Description | Data Type
|
||||
|
||||
### Example
|
||||
```powershell
|
||||
$XSailPointExperimental = "true" # String | Use this header to enable this experimental API. (default to "true")
|
||||
|
||||
# List predefined select options.
|
||||
|
||||
try {
|
||||
Search-V2024PreDefinedSelectOptions -XSailPointExperimental $XSailPointExperimental
|
||||
Search-V2024PreDefinedSelectOptions
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# Search-V2024PreDefinedSelectOptions -XSailPointExperimental $XSailPointExperimental
|
||||
# Search-V2024PreDefinedSelectOptions
|
||||
} catch {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Search-V2024PreDefinedSelectOptions"
|
||||
Write-Host $_.ErrorDetails
|
||||
@@ -1088,9 +1003,6 @@ try {
|
||||
[[Back to top]](#)
|
||||
|
||||
## 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)
|
||||
@@ -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
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
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 | 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.
|
||||
@@ -1126,7 +1037,6 @@ Code | Description | Data Type
|
||||
### Example
|
||||
```powershell
|
||||
$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)
|
||||
$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)
|
||||
@@ -1145,10 +1055,10 @@ $FormElementPreviewRequest = @"{
|
||||
# Preview form definition data source.
|
||||
|
||||
try {
|
||||
Show-V2024PreviewDataSource -FormDefinitionID $FormDefinitionID -XSailPointExperimental $XSailPointExperimental
|
||||
Show-V2024PreviewDataSource -FormDefinitionID $FormDefinitionID
|
||||
|
||||
# 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 {
|
||||
Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Show-V2024PreviewDataSource"
|
||||
Write-Host $_.ErrorDetails
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user