Update a connection

Artikel
01/06/2016

The Update a connection operation updates a connection with the specified data.

Request

To specify the request, replace <subscription-id> with your subscription ID, <cloud-service-name> with the name of the cloud service to use for making the request, <automation-account-name> with the name of the automation account to use for making the request, and <connection-name> with the name of the connection to update. Include required URI parameters.

Method	Request URI
PATCH	https://management.core.windows.net/<subscription-id>/cloudServices/<cloud-service-name>/resources/automation/~/automationAccounts/<automation-account-name>/connections/<connection-name>?api-version=2014-12-08

URI Parameters

Parameter	Description
api-version	Required. Must be set to 2014-12-08.

Request Headers

The request headers in the following table are required.

Request Header	Description
Content-Type	Set to application/json. Do not include a specification for charset.
x-ms-version	Specifies the version of the operation. Set to 2013-06-01 or a later version.

Request Body

In this example, the Owner field is updated to Litware Datacenter. The other field values must be provided because they are mandatory fields according to the connection type.

{
   "name":"Twitter",
   "properties":{
      "fieldDefinitionValues":{
         "Owner":"Litware Datacenter",
         "ConsumerAPIKey":"Pv6bmBg5uE2xXBUPQP9tmyW/DDB15LJAoXiT6NJFymE=",
         "ConsumerAPISecret":"C2ziW4nwt06xLTE4F5yrEfM3WSKol1JIjf0TG5RPchF0SMUnig1eSZhd/ol5KDwnLAuSm34ctkSQcfm0zEvTPlddqFvPxgFOhfmU4qapDkjXyZ82ZCcjSqAbyiYQnlTJmszzKyTHUESccBcPihHJ0iYP0CTTIb5Brr/SiVM/hxscrKizWR5aTLSUON9ga6kGqerCPQnP4EyZls/NsbGfbx8xOEh3N+FFnRFqyu5BAMxwkRf5Aat6S40vvvRNR7naVD6Zg6zTnkqnGPVpeud2ayjfkBfRPWRKkinmIcCTUICI4YvYGTgNRqbUanpV8932+wZKW6GfbUOv/y8h3/01Aw==",
         "AccessToken":"asBcGOJsDE6r552BCT6rTbvBnkBP775KiFM0MNwgn2U=",
         "AccessTokenSecret":"8j7bUCcjhkK9W8SxhmSspvWMBxMysSZKt4xwelcgPEUQL2T4y3T+RKyrvfHLsP0zEPL77R62W0aTD6zt7Luueb7B9YZIFIBOt35UwRTXCKlzWP9SZj4RQKe/q6nKGB/tigFkGnhE1kqorao1+G/r3bizAQXCkONPh7Tr6v5yUFx+e8sxNJsbQodJk7/NUp23CxjuXXHmyEuicDExMwicTCBbY/SdjzhAkvc3q7PBSBat4ymJKB+KSrS4hogTa+3dcbJvtHU7mEymlPE3cUWRFu9XbsjGo7JDn3NOlKxZkX+5gFk4LlVtT7Mn4hPVAiCodDdnkvXSoEWuQ5qgU/ZA4Q=="
      }
   }
}

Element	Description
name	Name of the connection. Note that the name is also provided in the URI and they must match.
description	A description of the connection.
fieldDefinitionValues/name	The name of a field defined by the connection type.
fieldDefinitionValues/value	The current value for the field.

Response

Status Code

A successful operation returns 200 (OK). For information about common error codes, see HTTP/1.1 Status Code Definitions.

Response Headers

Request Header	Description
x-ms-request-id	A unique identifier for the current operation.

Response Body

{
   "name":"Twitter",
   "properties":{
      "creationTime":"2015-05-19T17:27:07.93+00:00",
      "lastModifiedTime":"2015-05-19T18:12:06.043+00:00",
      "description":"Twitter connection",
      "fieldDefinitionValues":{
         "Owner":"Litware Datacenter",
         "ConsumerAPIKey":null,
         "ConsumerAPISecret":null,
         "AccessToken":null,
         "AccessTokenSecret":null
      },
      "connectionType":{
         "name":"LitwareTwitter"
      }
   }
}

Element	Description
name	Name of the connection.
description	A description of the connection.
fieldDefinitionValues	Updated values. Encrypted values are returned as null.
creationTime	The date and time the connection was created.
lastModifiedTime	The date and time the connection was last modified.

Share via