---
updatedAt: 2026-05-21T18:12:22.000Z
---
# V2 Récupérer toutes les instances de sources d'identité du locataire.
L'interface REST qui récupère toutes les instances de la source d'identité du locataire.
NOTE : Si la source d'identité a des propriétés V1, elles sont traduites en équivalents V2. Voir le tableau dans les descriptions PUT et POST de V2
Les droits sont requis : readIdentitySources, manageIdentitySources
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"version": "1.0.0",
"description": "IBM Verify API",
"title": "IBM Verify API"
},
"servers": [
{
"url": "https://{tenanturl}",
"variables": {
"tenanturl": {
"default": "{tenant_url}",
"description": "URL of your IBM Security Verify tenant"
}
}
}
],
"tags": [
{
"name": "Identity Sources V2"
}
],
"paths": {
"/v2.0/identitysources": {
"get": {
"tags": [
"Identity Sources V2"
],
"summary": "V2 Récupérer toutes les instances de sources d'identité du locataire.",
"description": "L'interface REST qui récupère toutes les instances de la source d'identité du locataire.
NOTE : Si la source d'identité a des propriétés V1, elles sont traduites en équivalents V2. Voir le tableau dans les descriptions PUT et POST de V2
Les droits sont requis : readIdentitySources, manageIdentitySources",
"operationId": "getInstancesV2",
"parameters": [
{
"name": "filter",
"in": "query",
"description": "Vous pouvez utiliser les filtres suivants pour récupérer les instances de source d'identité avec des propriétés spécifiques.
enduser : Renvoie toutes les instances de sources d'identité qui sont activées pour les utilisateurs finaux, c'est-à-dire les instances dont la valeur de la propriété show_end_user est définie comme true.
appscope : Renvoie toutes les sources d'identité sociales, à l'exclusion de la source d'identité IBMid, qui sont associées à des applications personnalisées.
Indépendamment de ce filtre, Cloud Directory est inclus en tant que fournisseur par défaut.",
"schema": {
"type": "string",
"enum": [
"enduser",
"appscope"
]
}
},
{
"name": "search",
"in": "query",
"description": "Le préfixe de toutes les opérations de recherche est recherche=.
Vous pouvez effectuer une recherche sur les champs suivants : id, sourceTypeId, instanceName, enabled
Spécifier un champ autre que les champs de recherche autorisés dans les critères entraînera une erreur.
Les opérateurs valides pour les chaînes de caractères sont =,!= et contient
Les opérateurs valides pour les booléens sont = et!=
Les opérateurs valides pour les nombres sont =,!=, >=, >, <=, et <
Les valeurs de recherche des chaînes doivent être mises entre guillemets; les nombres et les booléens ne doivent pas être mis entre guillemets. Plusieurs critères de recherche peuvent être spécifiés en utilisant les opérateurs \"et\" et \"ou\".
La valeur du paramètre de recherche DEVOIT être codée URL.
Notes: Seule la valeur doit être codée; pas le nom du paramètre. Le codage n'est pas nécessaire lors de l'utilisation de Swagger UI.
Exemples:
a. Pour effectuer une recherche sur instanceName,, indiquez les critères de recherche comme suit :
instanceName = \"Baidu\"
ou sous la forme codée URL comme suit :
search=instanceName%20%3D%20%22Baidu%22
b. Pour effectuer une recherche sur instanceName contenant SAML, indiquez les critères de recherche comme suit :
instanceName contient SAML
ou sous forme encodée URL comme suit :
search=instanceName%20contains%20%22SAML%22
c. Pour rechercher les instances d' SAML Enterprise dont le nom contient ABC, indiquez les critères de recherche suivants :
instanceName contient ABC et sourceTypeId = 4
ou sous forme encodée URL comme suit :
search=instanceName%20contains%20%22ABC%22%20and%20sourceTypeId%20%3D%204
",
"schema": {
"type": "string"
}
},
{
"name": "pagination",
"in": "query",
"description": "Le préfixe du paramètre de pagination est pagination=.
Si les paramètres de pagination ne sont pas spécifiés, tous les résultats seront renvoyés.
Si les paramètres de pagination sont spécifiés, les résultats seront paginés. Les paramètres suivants peuvent être spécifiés; ils seront inclus dans la réponse reflétant les résultats réels.
page : la page demandée, ou le décalage qui définit le numéro de la ressource de départ.
limite : il s'agit d'une taille de page; elle définit le nombre total de ressources qui peuvent être incluses dans une page. C'est le nombre maximum de ressources qui seront renvoyées dans la réponse.count : Le nombre total de ressources à renvoyer dans la réponse. Il s'agit d'un paramètre facultatif qui DOIT être inférieur ou égal à la limite. Si elle n'est pas spécifiée, alors count = limit.
La valeur du paramètre de pagination DEVOIT être codée URL.
Note: Seule la valeur doit être codée; pas le nom du paramètre. Le codage n'est pas nécessaire lors de l'utilisation de Swagger UI.
Note: La valeur maximale autorisée pour les champs limit ou count est de 1000.
Exemples:
a. Pour extraire les 5 premières ressources ou moins de la page 1, indiquez les paramètres de pagination comme suit :
count=5&page=1&limit=10
ou sous la forme codée URL comme suit :
pagination=count%3D5%26page%3D1%26limit%3D10
b. Pour extraire les 3 premières ressources ou moins de la page 2, indiquez les paramètres de pagination comme suit :
count=3&page=2&limit=10
ou sous la forme codée URL comme suit :
pagination=count%3D3%26page%3D2%26limit%3D10
",
"schema": {
"type": "string"
}
},
{
"name": "sort",
"in": "query",
"description": "Le préfixe du paramètre de tri est sort=.
Vous pouvez effectuer un tri sur les champs suivants : id, sourceTypeId, instanceName, enabled
Spécifier un champ autre que les champs de tri autorisés entraînera une erreur.
Chaque attribut de tri doit être préfixé par + ou - (+ ascendant, - descendant). Une liste d'attributs séparés par une virgule (,) peut être spécifiée pour le deuxième ou le troisième ordre de tri.
La valeur du paramètre de tri DEVOIT être codée URL.
Note: Seule la valeur doit être codée; pas le nom du paramètre. Le codage n'est pas nécessaire lors de l'utilisation de Swagger UI.
Exemples:
a. Pour trier par ordre croissant sur sourceTypeId, indiquez le paramètre de tri comme suit :
+sourceTypeId
ou sous la forme codée URL comme suit :
sort=%2BsourceTypeId
b. Pour trier sur sourceTypeId dans l'ordre croissant et pour un tri de deuxième ordre sur instanceName dans l'ordre décroissant, fournir le paramètre de tri comme suit :
+sourceTypeId,-instanceName
ou sous la forme codée URL comme suit :
sort=%2BsourceTypeId%2C-instanceName
",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Demande réussie. Les sources d'identité ont été récupérées.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/IdentitySourceIntancesDataList"
}
}
}
},
"400": {
"description": "La réponse JSON était malformée.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequest_0"
}
}
}
},
"403": {
"description": "Vous n'êtes pas autorisé à accéder à cette ressource.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Forbidden_0"
}
}
}
},
"404": {
"description": "La recherche a échoué. Le système n'a pas pu retrouver les sources d'identité.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFound"
}
}
}
}
},
"x-publicAPI": "true",
"x-category": "IBM Verify API"
}
}
},
"components": {
"schemas": {
"AttributeMapping": {
"required": [
"attrId",
"idsAttrName",
"jitpOption"
],
"type": "object",
"properties": {
"attrId": {
"type": "string",
"description": "L'identifiant de l'attribut IBM Security Verify Cloud Directory.",
"example": "12"
},
"jitpOption": {
"type": "string",
"description": "L'identifiant de l'attribut IBM Security Verify Cloud Directory.",
"example": "ALWAYS",
"enum": [
"ALWAYS",
"CREATE",
"DISABLED",
"NONE"
]
},
"idsAttrName": {
"type": "string",
"description": "Nom de l'attribut de la source d'identité externe. Nécessaire uniquement si la source d'identité n'est pas Cloud Directory.",
"example": "dept"
},
"postEval": {
"$ref": "#/components/schemas/PostEval"
}
}
},
"PostEval": {
"required": [
"custom",
"id"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Une fonction d'attribut valide. Cela transformera la cartographie des attributs. Seule l'une des deux options \"id\" ou \"custom\" peut être définie dans une cartographie d'attributs.",
"example": "uppercase"
},
"custom": {
"type": "string",
"description": "Une règle personnalisée pour la transformation. Cela transformera la cartographie des attributs. Seule l'une des deux options \"id\" ou \"custom\" peut être définie dans une cartographie d'attributs."
}
}
},
"IdentitySourceInstancesPropertiesData": {
"required": [
"key",
"sensitive",
"value"
],
"type": "object",
"properties": {
"sensitive": {
"type": "boolean",
"description": "Indique si cette propriété contient des secrets qui ne doivent pas être divulgués. Si la propriété est sensible, la valeur de la propriété sera masquée par des astérisques.",
"example": false
},
"key": {
"type": "string",
"description": "Clé de propriété.",
"example": "realm"
},
"value": {
"type": "string",
"description": "Valeur de la propriété. Les valeurs secrètes seront masquées par des astérisques.",
"example": "cloudIdentityRealm"
}
}
},
"IdentitySourceInstancesData": {
"required": [
"enabled",
"instanceName",
"properties",
"sourceTypeId"
],
"type": "object",
"properties": {
"sourceTypeId": {
"maximum": 17,
"minimum": 1,
"type": "integer",
"description": "L'identifiant numérique du type de fournisseur d'identité.",
"format": "int32",
"example": 5
},
"instanceName": {
"type": "string",
"description": "Le nom de l'instance à afficher sur la page de sélection des connexions.",
"example": "Cloud Directory"
},
"enabled": {
"type": "boolean",
"description": "Indicateur booléen indiquant si cette instance est activée ou désactivée. Seules les instances de sources d'identité activées sont affichées sur la page de sélection des connexions. ",
"example": true
},
"status": {
"type": "string",
"description": "Une chaîne de caractères indiquant si cette instance est configurée. Si elle est spécifiée, cette propriété est ignorée lors de la création. ",
"example": "configured ",
"enum": [
"configured",
"unconfigured"
]
},
"predefined": {
"type": "boolean",
"description": "Ce bien n'est actuellement pas utilisé. Nous ne prenons pas en charge l'intégration d'autres types de fournisseurs d'identité personnalisés.\n Cependant, l'objectif était d'indiquer que cette instance est spéciale; elle ne peut être ni créée ni supprimée.",
"example": false
},
"properties": {
"type": "array",
"description": "Ensemble de propriétés associées à l'instance de source d'identité.\n Il s'agit d'un tableau de propriétés de l'instance de source d'identité qui sont nécessaires pour effectuer le flux de connexion au moment de l'exécution.\n Les propriétés et le nombre de propriétés varient en fonction du type de prestataire.",
"items": {
"$ref": "#/components/schemas/IdentitySourceInstancesPropertiesData"
}
},
"attributeMappings": {
"type": "array",
"description": "Ensemble de mappages d'attributs associés à l'instance de source d'identité.\n Il s'agit d'un tableau de correspondances d'attributs qui ne sont pas obligatoires mais facultatives pour certains flux de connexion au moment de l'exécution.\n Les propriétés et le nombre de propriétés diffèrent selon le type de fournisseur.",
"items": {
"$ref": "#/components/schemas/AttributeMapping"
}
}
}
},
"IdentitySourceIntancesDataList": {
"required": [
"identitySources",
"total"
],
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "Nombre total d'intances de sources d'identité configurées pour le locataire.",
"format": "int32",
"example": 1
},
"identitySources": {
"type": "array",
"description": "Liste des intances de sources d'identité configurées pour le locataire.",
"items": {
"$ref": "#/components/schemas/IdentitySourceInstancesData"
}
}
}
},
"NotFound": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé du message.",
"example": "CSIAG0605E"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur.",
"example": "The retrieval failed because the resource wasn't found"
}
}
},
"BadRequest_0": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé du message.",
"example": "CSIAG5401E"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur.",
"example": "The request failed because the request body contains improperly structured JSON."
}
}
},
"Forbidden_0": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé du message.",
"example": "CSIAK4300E"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique au local du demandeur.",
"example": "You are not authorized to access this resource."
}
}
}
}
},
"x-original-swagger-version": "2.0",
"x-explorer-enabled": false
}
```