Namespace: microsoft.graph
Aktualisieren Sie die Eigenschaften eines externalOriginResourceConnector-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
EntitlementManagement.ReadWrite.All |
Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
EntitlementManagement.ReadWrite.All |
Nicht verfügbar. |
HTTP-Anforderung
PATCH /identityGovernance/entitlementManagement/externalOriginResourceConnectors/{externalOriginResourceConnectorId}
Anforderungstext
Geben Sie im Anforderungstext nur die Werte für die zu aktualisierenden Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.
In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.
| Eigenschaft |
Typ |
Beschreibung |
| connectionInfo |
connectionInfo |
Die Verbindungsinformationen, die für die Kommunikation mit dem externen Ressourcensystem verwendet werden. |
| connectorType |
connectorType |
Der Typ der Verbindung. Die möglichen Werte sind: sapIag, unknownFutureValue. |
| description |
Zeichenfolge |
Eine Beschreibung des Connectors. |
| displayName |
Zeichenfolge |
Der Anzeigename des Connectors. |
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und ein aktualisiertes externalOriginResourceConnector-Objekt im Antworttext zurück.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
PATCH https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/externalOriginResourceConnectors/e363ebb8-6faa-4980-ac5b-eefc196e1cd4
Content-Type: application/json
{
"connectorType": "sapIag",
"displayName": "SAP IAG Connector 2.0",
"description": "SAP IAG Connector 2.0 description",
"connectionInfo": {
"@odata.type": "microsoft.graph.externalTokenBasedSapIagConnectionInfo",
"url": "https://contoso.example.com",
"keyVaultName": "Keyvault",
"subscriptionId": "5ee98b73-d9df-43a7-8a92-36855054bdee",
"resourceGroup": "SAP IAG Group",
"accessTokenUrl": "https://contoso.example.com/oauth/token",
"clientId": "e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29",
"secretName": "clientSecret"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new ExternalOriginResourceConnector
{
ConnectorType = ConnectorType.SapIag,
DisplayName = "SAP IAG Connector 2.0",
Description = "SAP IAG Connector 2.0 description",
ConnectionInfo = new ExternalTokenBasedSapIagConnectionInfo
{
OdataType = "microsoft.graph.externalTokenBasedSapIagConnectionInfo",
Url = "https://contoso.example.com",
KeyVaultName = "Keyvault",
SubscriptionId = "5ee98b73-d9df-43a7-8a92-36855054bdee",
ResourceGroup = "SAP IAG Group",
AccessTokenUrl = "https://contoso.example.com/oauth/token",
ClientId = "e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29",
SecretName = "clientSecret",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.IdentityGovernance.EntitlementManagement.ExternalOriginResourceConnectors["{externalOriginResourceConnector-id}"].PatchAsync(requestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewExternalOriginResourceConnector()
connectorType := graphmodels.SAPIAG_CONNECTORTYPE
requestBody.SetConnectorType(&connectorType)
displayName := "SAP IAG Connector 2.0"
requestBody.SetDisplayName(&displayName)
description := "SAP IAG Connector 2.0 description"
requestBody.SetDescription(&description)
connectionInfo := graphmodels.NewExternalTokenBasedSapIagConnectionInfo()
url := "https://contoso.example.com"
connectionInfo.SetUrl(&url)
keyVaultName := "Keyvault"
connectionInfo.SetKeyVaultName(&keyVaultName)
subscriptionId := "5ee98b73-d9df-43a7-8a92-36855054bdee"
connectionInfo.SetSubscriptionId(&subscriptionId)
resourceGroup := "SAP IAG Group"
connectionInfo.SetResourceGroup(&resourceGroup)
accessTokenUrl := "https://contoso.example.com/oauth/token"
connectionInfo.SetAccessTokenUrl(&accessTokenUrl)
clientId := "e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29"
connectionInfo.SetClientId(&clientId)
secretName := "clientSecret"
connectionInfo.SetSecretName(&secretName)
requestBody.SetConnectionInfo(connectionInfo)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
externalOriginResourceConnectors, err := graphClient.IdentityGovernance().EntitlementManagement().ExternalOriginResourceConnectors().ByExternalOriginResourceConnectorId("externalOriginResourceConnector-id").Patch(context.Background(), requestBody, nil)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
ExternalOriginResourceConnector externalOriginResourceConnector = new ExternalOriginResourceConnector();
externalOriginResourceConnector.setConnectorType(ConnectorType.SapIag);
externalOriginResourceConnector.setDisplayName("SAP IAG Connector 2.0");
externalOriginResourceConnector.setDescription("SAP IAG Connector 2.0 description");
ExternalTokenBasedSapIagConnectionInfo connectionInfo = new ExternalTokenBasedSapIagConnectionInfo();
connectionInfo.setOdataType("microsoft.graph.externalTokenBasedSapIagConnectionInfo");
connectionInfo.setUrl("https://contoso.example.com");
connectionInfo.setKeyVaultName("Keyvault");
connectionInfo.setSubscriptionId("5ee98b73-d9df-43a7-8a92-36855054bdee");
connectionInfo.setResourceGroup("SAP IAG Group");
connectionInfo.setAccessTokenUrl("https://contoso.example.com/oauth/token");
connectionInfo.setClientId("e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29");
connectionInfo.setSecretName("clientSecret");
externalOriginResourceConnector.setConnectionInfo(connectionInfo);
ExternalOriginResourceConnector result = graphClient.identityGovernance().entitlementManagement().externalOriginResourceConnectors().byExternalOriginResourceConnectorId("{externalOriginResourceConnector-id}").patch(externalOriginResourceConnector);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
const options = {
authProvider,
};
const client = Client.init(options);
const externalOriginResourceConnector = {
connectorType: 'sapIag',
displayName: 'SAP IAG Connector 2.0',
description: 'SAP IAG Connector 2.0 description',
connectionInfo: {
'@odata.type': 'microsoft.graph.externalTokenBasedSapIagConnectionInfo',
url: 'https://contoso.example.com',
keyVaultName: 'Keyvault',
subscriptionId: '5ee98b73-d9df-43a7-8a92-36855054bdee',
resourceGroup: 'SAP IAG Group',
accessTokenUrl: 'https://contoso.example.com/oauth/token',
clientId: 'e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29',
secretName: 'clientSecret'
}
};
await client.api('/identityGovernance/entitlementManagement/externalOriginResourceConnectors/e363ebb8-6faa-4980-ac5b-eefc196e1cd4')
.update(externalOriginResourceConnector);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ExternalOriginResourceConnector;
use Microsoft\Graph\Generated\Models\ConnectorType;
use Microsoft\Graph\Generated\Models\ExternalTokenBasedSapIagConnectionInfo;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ExternalOriginResourceConnector();
$requestBody->setConnectorType(new ConnectorType('sapIag'));
$requestBody->setDisplayName('SAP IAG Connector 2.0');
$requestBody->setDescription('SAP IAG Connector 2.0 description');
$connectionInfo = new ExternalTokenBasedSapIagConnectionInfo();
$connectionInfo->setOdataType('microsoft.graph.externalTokenBasedSapIagConnectionInfo');
$connectionInfo->setUrl('https://contoso.example.com');
$connectionInfo->setKeyVaultName('Keyvault');
$connectionInfo->setSubscriptionId('5ee98b73-d9df-43a7-8a92-36855054bdee');
$connectionInfo->setResourceGroup('SAP IAG Group');
$connectionInfo->setAccessTokenUrl('https://contoso.example.com/oauth/token');
$connectionInfo->setClientId('e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29');
$connectionInfo->setSecretName('clientSecret');
$requestBody->setConnectionInfo($connectionInfo);
$result = $graphServiceClient->identityGovernance()->entitlementManagement()->externalOriginResourceConnectors()->byExternalOriginResourceConnectorId('externalOriginResourceConnector-id')->patch($requestBody)->wait();
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.external_origin_resource_connector import ExternalOriginResourceConnector
from msgraph.generated.models.connector_type import ConnectorType
from msgraph.generated.models.external_token_based_sap_iag_connection_info import ExternalTokenBasedSapIagConnectionInfo
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ExternalOriginResourceConnector(
connector_type = ConnectorType.SapIag,
display_name = "SAP IAG Connector 2.0",
description = "SAP IAG Connector 2.0 description",
connection_info = ExternalTokenBasedSapIagConnectionInfo(
odata_type = "microsoft.graph.externalTokenBasedSapIagConnectionInfo",
url = "https://contoso.example.com",
key_vault_name = "Keyvault",
subscription_id = "5ee98b73-d9df-43a7-8a92-36855054bdee",
resource_group = "SAP IAG Group",
access_token_url = "https://contoso.example.com/oauth/token",
client_id = "e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29",
secret_name = "clientSecret",
),
)
result = await graph_client.identity_governance.entitlement_management.external_origin_resource_connectors.by_external_origin_resource_connector_id('externalOriginResourceConnector-id').patch(request_body)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.externalOriginResourceConnector",
"id": "e363ebb8-6faa-4980-ac5b-eefc196e1cd4",
"displayName": "SAP IAG Connector 2.0",
"description": "SAP IAG Connector 2.0 description",
"connectorType": "sapIag",
"connectionInfo": {
"@odata.type": "microsoft.graph.externalTokenBasedSapIagConnectionInfo",
"url": "https://contoso.example.com",
"accessTokenUrl": "https://contoso.example.com/oauth/token",
"clientId": "e9ad8b1d-959c-4e86-8ba2-2cbf4d14bc29",
"keyVaultName": "Keyvault",
"secretName": "clientSecret",
"subscriptionId": "5ee98b73-d9df-43a7-8a92-36855054bdee",
"resourceGroup": "SAP IAG Group"
},
"createdBy": "admin@contoso.com",
"createdDateTime": "2026-02-23T10:15:30Z",
"modifiedBy": "admin@contoso.com",
"modifiedDateTime": "2026-02-24T11:20:10Z"
}