Editing created components with REST APIs

Edit online

After you create volumes or data set components from z/OS® systems, you can edit the component, or create a new version and duplicate for the component.

Procedure

  1. Call the REST API to authenticate the ssh connection to the z/OS system. 
    curl -k -u zdtadmin:password -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ "system-uuid": "systemuuid", "username": "zosuser",  "password": "zospw"}' 'https://your_tools_server_host_name:9443/ZDTREST/zdtrs/auth-services/v3/authenticate-ssh'​​​​​​​
    The following response is displayed. 
    {"expiration":1516202935577,"username":"ZOSUSER","password":"ZOSPW","token":"VVNFUjM1NTE4ODczMjY3NjU=","port":22}
  2. Run the following command to submit the request. 
    curl -k -u zdtadmin:password -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'SSHAuthorization: {"token":"dXNlcjM1NTg5OTg4OTgwNA==","hostname":"YOUR_Z_OS_HOST_NAME","port":22} ' -d ' {"name": "name of the component","zSystem": {"hostname": "myzos.domain.com","port": 22},"version": 1,"newInfo": {"name": "new name","description": "new comment","systemType": "COMP_SYSTEM_TYPE_ZSYSTEM_ENV","concurrentExtractionNumber": 3},"addItems": ["volume to be added"],"removeItems": ["volume to be removed"],"refreshItems": ["volume to be refreshed"],"duplicate": false,"newVersion": false,"schedules": {"originalScheduleTime": "2018-01-06 13:01:00.0","originalScheduleTimezoneId": "CTT"}}' 'https://your_tools_server_host_name:9443/ZDTREST/zdtrs/componentServices/component'