更新

指定した中継許可設定を更新します。

Request Interface

HTTP Request

PUT /relay/permission/{connectionId}/{remoteConnectionId}/{direction}

Parameter

Path Parameter	Value	Required	Description
connectionId	string	true	Connection ID of the local machine to be updated
remoteConnectionId	string	true	Connection ID of the remote machine to be updated
direction	string	true	Transfer direction to be updated

Request Parameter	Value	Required	Description	Default Value
enabled	string	false	Whether to enable Relay Authorization Settings or not	No update
memo	string	false	Note for the settings	No update

Authorization

Management Console の [API キー管理] 画面の「スコープ」で、「中継許可設定」の「更新」を選択する必要があります。

Response Interface

リクエストが正常に処理された場合、以下の JSON フォーマットでレスポンスを返却します。

{
    "connectionId":"id1",
    "remoteConnectionId":"id2",
    "direction":"send",
    "enabled":"true",
    "memo":"memo1"
}

Property Name	Value	Description
connectionId	string	Connection ID of the local machine to be updated
remoteConnectionId	string	Connection ID of the remote machine to be updated
direction	string	Transfer direction to be updated
enabled	string	Whether to enable Relay Authorization Settings or not
memo	string	Note for the settings

Examples

Java JavaScript

public static void main(String[] args) {
    String host = "https://www.webconnect.hulft.com";
    String apiKey = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
    String connectionId = "xxxxxxxx";
    String remoteConnectionId = "xxxxxxxx";
    String direction = "send";
    try {
        URL url = new URL(host + "/api/v2/relay/permission/" + connectionId + "/" + remoteConnectionId + "/" + direction);
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        String putData = "{\"enabled\":\"true\", \"memo\":\"xxxxxxxxx\"}";

        connection.setRequestMethod("PUT");
        connection.setDoOutput(true);
        connection.setDoInput(true);
        connection.setRequestProperty("Authorization", "Bearer " + apiKey);
        connection.setRequestProperty("Content-Type", "application/json");
        connection.setRequestProperty("Content-Length", Integer.toString(putData.length()));
        try (BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(connection.getOutputStream()))) {
            writer.write(putData);
        }
        try (BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()))) {
            String line;
            while ((line = reader.readLine()) != null) {
                System.out.println(line);
            }
        }
    } catch (IOException ex) {
        // error
    }
}

// load jquery 
var host = 'https://www.webconnect.hulft.com';
var apiKey = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
var connectionId = 'xxxxxxxx';
var remoteConnectionId = 'xxxxxxxx';
var direction = 'send';
$.ajax({
  type: 'PUT',
  url: host + '/api/v2/relay/permission/' + connectionId + '/' + remoteConnectionId + '/' + direction,
  headers: {
    Authorization: 'Bearer ' + apiKey
  },
  contentType: 'application/json',
  data: JSON.stringify({enabled: 'true', memo: 'xxxxxxx'})
}).done(function(data, status, xhr) {
  console.log(data);
}).fail(function(data, status, xhr) {
  console.log(data);
});