Een referentieconfiguratie bijwerken

Deze pagina illustreert de API-aanvraag en lading die u kunt gebruiken om een bestaande referentieconfiguratie bij te werken met behulp van het API-eindpunt /authoring/credentials .

Wanneer gebruikt u het API-eindpunt /credentials when-to-use

Gebruik dit API-eindpunt om alleen een referentie-configuratie te maken als er een algemeen verificatiesysteem is tussen Adobe en uw doelplatform. De Experience Platform -klant hoeft geen verificatiegegevens op te geven om verbinding te maken met uw bestemming. In dit geval moet u een referentieconfiguratie maken met het API-eindpunt van /credentials .

Wanneer het gebruiken van een globaal authentificatiesysteem, moet u "authenticationRule":"PLATFORM_AUTHENTICATION" in de ​ 2} configuratie van de bestemmingslevering plaatsen, wanneer ​ creërend een nieuwe bestemmingsconfiguratie . ​ Dan, moet u de configuratie van de a ​ geloofsbrieven ​ tot stand brengen en identiteitskaart van de referentie objecten in de authenticationId parameter in de ​ configuratie van de bestemmingslevering ​ overgaan.

Aan de slag met API-bewerkingen voor gebruikersgegevens get-started

Alvorens verder te gaan, te herzien gelieve ​ begonnen gids ​ voor belangrijke informatie die u moet kennen om vraag aan API met succes te maken, met inbegrip van hoe te om de vereiste toestemming van de bestemmings authoring en vereiste kopballen te verkrijgen.

Een referentieconfiguratie bijwerken update

U kunt een ​ bestaande ​ credentiële configuratie bijwerken door een PUT verzoek aan het /authoring/credentials eindpunt met de bijgewerkte nuttige lading te doen.

Om een bestaande credentiële configuratie en zijn overeenkomstige {INSTANCE_ID} te verkrijgen, zie het artikel over ​ het terugwinnen van een credentiële configuratie ​.

API formaat

PUT /authoring/credentials/{INSTANCE_ID}

De volgende verzoeken werken bestaande credentiële configuraties bij, die door de parameters worden bepaald die in de lading worden verstrekt.

Selecteer hieronder elk tabblad om de bijbehorende lading weer te geven.

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/credentials/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "basicAuthentication":{
      "url":"string",
      "username":"string",
      "password":"string"
   }
}

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/credentials/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "s3Authentication":{
      "accessId":"string",
      "secretKey":"string"
   }
}

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/credentials/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "sshAuthentication":{
      "username":"string",
      "sshKey":"string"
   }
}

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/credentials/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "azureAuthentication":{
      "url":"string",
      "tenant":"string",
      "servicePrincipalId":"string",
      "servicePrincipalKey":"string"
   }
}

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/credentials/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "azureConnectionStringAuthentication":{
      "connectionString":"string"
   }
}

API-foutafhandeling error-handling

Destination SDK API-eindpunten volgen de algemene beginselen van Experience Platform API-foutberichten. Verwijs naar ​ API statuscodes ​ en ​ de fouten van de verzoekkopbal ​ in de het oplossen van problemengids van Experience Platform.

Volgende stappen next-steps

Nadat u dit document hebt gelezen, weet u nu hoe u een referentieconfiguratie kunt bijwerken met behulp van het API-eindpunt van /authoring/credentials . Lees ​ hoe te om Destination SDK te gebruiken om uw bestemming ​ te vormen om te begrijpen waar deze stap in het proces past om uw bestemming te vormen.