Skip to main content

ワークフローエンドポイント

ワークフローのエンドポイントとパラメーター

オブジェクト関係に関する詳細とAPIでの使用方法については、オブジェクト関係 のセクションを参照してください。

ワークフローの詳細については、「ワークフロー」に関するヘルプページを参照してください。

新しいワークフローをアップロードする

新しいワークフローをアップロードするには、POST {baseURL}/v3/workflowsエンドポイントを使用します。

パラメーター

  • file (ファイル): 必須です。システムにアップロードする実際のファイルを選択します。メディアタイプはYXZPファイルである必要があります。

  • name (文字列): 必須です。ワークフロー名を入力します。Server UIに表示するワークフローの名前です。

  • ownerId (文字列): 必須です。所有者の名前を入力します。

  • workerTag (文字列): オプションです。ワーカーで定義されたワーカータグを指定して、特定のワーカーノードにジョブを割り当てる際に役立てることができます。詳細については、ワーカーのヘルプページを参照してください。

  • districtTags (文字列): オプションです。JSON形式の配列(例: ["id1", "id2"])で送信します。ディストリクトを使用すると、共有されたパブリックワークフローをタグでグループ化し、ユーザーが簡単に見つけられるようにすることができます。詳細については、「ディストリクト」ヘルプページを参照してください。

  • comments (文字列): オプションです。コメントを入力します。

  • isPublic (ブール型): 必須です。ワークフローを公開する場合は、「true」を選択します。ワークフローを非公開にして利用できないようにする場合は、「false」を選択します。

  • isReadyForMigration (ブール型): 必須です。このワークフローを移行対象にするか否かを選択します。あるServer環境から別のServer環境への移行の詳細については、「ワークフローを移行できるようにする」ヘルプページを参照してください。

  • sourceAppId (文字列): オプションです。ワークフローのソースアプリケーション ID を設定します。POST admin/v1/workflowsエンドポイントの「sourceId」リファレンスとして使用できます。既存のsourceAppIdを指定すると、リクエストが無効になります。

  • othersMayDownload (ブール型): 必須です。他のユーザーによるこのワークフローのダウンロードを可能にするか否かを指定します。

  • othersCanExecute (ブール型): 必須です。他のユーザーによるこのワークフローの実行を可能にするか否かを指定します。

  • executionMode (文字列): 必須です。使用可能な値は「Safe」、「SemiSafe」、「Standard」です。実行モードの詳細については、「セーフモードおよび準セーフ実行モード: ブロックされるツール、イベント、データコネクタ」ヘルプページを参照してください。

  • hasPrivateDataExemption (ブール型): オプションです。プライベートデータを含むワークフローを実行できるように、適用除外を設定します。適用除外を許可する場合は「true」、適用除外を許可しない場合は「false」を選択します。詳細については、管理者のワークフローオプションページを参照してください。

  • workflowCredentialType (文字列): 必須です。使用できる値は、「Default」(既定)、「Required」(必須)、「Specific」(指定)です。

  • credentialId (文字列): オプションです。このワークフローのcredentialIdを指定します。

  • collectionIds (文字列): オプションです。このワークフローを追加するcollectionIdを入力します。JSON形式の配列(例: ["id1", "id2"])で送信します。

curl -X 'POST' \
  'http://localhost/webapi/v3/workflows' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@Workflow2.yxzp;type=application/yxzp' \
  -F 'name=Workflow2' \
  -F 'ownerId=66ebd0896e52ae73b4951072' \
  -F 'isPublic=true' \
  -F 'isReadyForMigration=true' \
  -F 'othersMayDownload=true' \
  -F 'othersCanExecute=false' \
  -F 'executionMode=Standard' \
  -F 'workflowCredentialType=Default'
  • 200: OK

    "string"
  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

既存ワークフローに新しいバージョンをアップロードする

既存のワークフローに新しいバージョンをアップロードするには、POST {baseURL}/v3/workflows/{workflowId}/versionsエンドポイントを使用します。

パラメーター

  • workflowId (文字列): 必須です。新しいバージョンをアップロードするワークフローIDを入力します。

  • file (ファイル): 必須です。新しいバージョンとしてシステムにアップロードする実際のファイルを選択します。メディアタイプはYXZPファイルである必要があります。

  • name (文字列): 必須です。ワークフロー名を入力します。Server UIに表示するワークフローの名前です。

  • ownerId (文字列): 必須です。所有者の名前を入力します。

  • othersMayDownload (ブール型): 必須です。既定は「true」に設定されています。

  • othersCanExecute (ブール型): 必須です。既定は「true」に設定されています。

  • executionMode (文字列): 必須です。使用可能な値は「Safe」、「SemiSafe」、「Standard」です。実行モードの詳細については、「セーフモードおよび準セーフ実行モード: ブロックされるツール、イベント、データコネクタ」ヘルプページを参照してください。

  • hasPrivateDataExemption (ブール型): オプションです。プライベートデータを含むワークフローを実行できるように、適用除外を設定します。適用除外を許可する場合は「true」、適用除外を許可しない場合は「false」を選択します。詳細については、管理者のワークフローオプションページを参照してください。

  • comments (文字列): オプションです。コメントを入力します。

  • makePublished (ブール型): 必須です。既定は「true」に設定されています。makePublishedパラメーターは、Serverにプッシュするワークフローの新しいバージョンを公開バージョンとするか否かを制御するためのものです。ワークフローをServerにプッシュする際に値を「false」に設定することで、自分だけが実行することができるようになります。

  • workflowCredentialType (文字列): 必須です。このワークフローに使用する資格情報タイプを入力します。使用できる値は、「Default」(既定)、「Required」(必須)、「Specific」(指定)です。

  • credentialId (文字列): オプションです。このワークフローのcredentialIdを指定します。資格情報エンドポイントの詳細については、資格情報エンドポイントを参照してください。

curl -X 'POST' \
  'http://localhost/webapi/v3/workflows/66ebd18d6e52ae73b4951085/versions' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@Workflow3.yxzp;type=application/yxzp' \
  -F 'name=Workflow1_3' \
  -F 'ownerId=66ebd0896e52ae73b4951072' \
  -F 'othersMayDownload=true' \
  -F 'othersCanExecute=true' \
  -F 'executionMode=Standard' \
  -F 'makePublished=true' \
  -F 'workflowCredentialType=Default'
  • 200: OK

    {
      "id": "string",
      "sourceAppId": "string",
      "dateCreated": "2024-09-19T07:33:01.072Z",
      "runCount": 0,
      "versions": [
        {
          "versionId": "string",
          "versionNumber": 0,
          "dateCreated": "2024-09-19T07:33:01.072Z",
          "uploadSource": "Designer",
          "uploadDate": "2024-09-19T07:33:01.072Z",
          "packageWorkflowType": "App",
          "published": true,
          "comments": "string",
          "runDisabled": true,
          "executionMode": "Safe",
          "workflowCredentialType": "Default",
          "credentialId": "string",
          "hasPrivateDataExemption": true,
          "othersMayDownload": true,
          "othersCanViewHistory": true,
          "details": {
            "isAmp": true,
            "fileName": "string",
            "author": "string",
            "copyright": "string",
            "description": "string",
            "name": "string",
            "noOutputFilesMessage": "string",
            "outputMessage": "string",
            "url": "string",
            "urlText": "string"
          }
        }
      ],
      "name": "string",
      "ownerId": "string",
      "workerTag": "string",
      "districtTags": [
        "string"
      ],
      "comments": "string",
      "isPublic": true,
      "isReadyForMigration": true,
      "publishedVersionId": "string",
      "othersMayDownload": true,
      "othersCanViewHistory": true,
      "othersCanExecute": true,
      "executionMode": "Safe",
      "hasPrivateDataExemption": true
    }
  • 401: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

  • 404: パス内のworkflowIdが無効であることを示します。

すべてのワークフローを取得する

すべてのワークフローレコードに関する情報を取得するには、GET {baseURL}/v3/workflows/エンドポイントを使用します。

パラメーター

  • view (文字列): オプションです。ワークフロー情報の表示方法を選択します。値を指定しないこともできます。値は「Default」(既定)と「Full」(完全)から選択できます。このパラメーターを「Default」(既定)に設定すると、縮小表示オブジェクトが返されます。指定しない場合は、「Default」(既定)の値が使用されます。

  • name (文字列): オプションです。ワークフローを名前でフィルタリングする場合に備えて、ワークフローの名前を入力します。Server UIに表示するワークフローの名前です。

  • ownerId (文字列): オプションです。ワークフローを所有者でフィルタリングする場合に備えて、所有者のIDを入力します。

  • createdAfter (文字列): オプションです。ワークフローが作成された後の日付と時刻を入力します。日付と時刻を ISO8601形式 で入力します。

  • createdBefore (文字列): オプションです。ワークフローが作成される前の日付と時刻を入力します。日付と時刻を ISO8601形式 で入力します。

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

      {
        "id": "string",
        "sourceAppId": "string",
        "name": "string",
        "ownerId": "string",
        "dateCreated": "2024-08-15T11:14:56.965Z",
        "publishedVersionNumber": 0,
        "isAmp": true,
        "executionMode": "Safe"
      }
    ]
  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

特定のワークフローレコードを取得する

特定のワークフローに関する情報を取得するには、GET {baseURL}/v3/workflows/{workflowId}エンドポイントを使用します。

注記

管理者以外のユーザーも、アクセス権のあるワークフローにGET v3/workflows/{workflowId}エンドポイントを使用できます。以前は、このエンドポイントの使用は管理者のみに制限されていました。

パラメーター

  • workflowId (文字列): 必須です。このワークフローに関する情報を取得するには、ワークフローIDを入力します。

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

    {
      "id": "string",
      "sourceAppId": "string",
      "dateCreated": "2024-09-05T10:42:53.360Z",
      "runCount": 0,
      "versions": [
        {
          "versionId": "string",
          "versionNumber": 0,
          "dateCreated": "2024-09-05T10:42:53.360Z",
          "uploadSource": "Designer",
          "uploadDate": "2024-09-05T10:42:53.360Z",
          "packageWorkflowType": "App",
          "published": true,
          "comments": "string",
          "runDisabled": true,
          "executionMode": "Safe",
          "workflowCredentialType": "Default",
          "credentialId": "string",
          "hasPrivateDataExemption": true,
          "othersMayDownload": true,
          "othersCanViewHistory": true,
          "details": {
            "isAmp": true,
            "fileName": "string",
            "author": "string",
            "copyright": "string",
            "description": "string",
            "name": "string",
            "noOutputFilesMessage": "string",
            "outputMessage": "string",
            "url": "string",
            "urlText": "string"
          }
        }
      ],
      "name": "string",
      "ownerId": "string",
      "workerTag": "string",
      "districtTags": [
        "string"
      ],
      "comments": "string",
      "isPublic": true,
      "isReadyForMigration": true,
      "publishedVersionId": "string",
      "othersMayDownload": true,
      "othersCanViewHistory": true,
      "othersCanExecute": true,
      "executionMode": "Safe",
      "hasPrivateDataExemption": true
    }
  • 401: Unauthorized (権限がありません)

  • 404: NotFound (見つかりません)

既存のワークフローを更新する

既存のワークフローに関する情報を変更するには、PUT {baseURL}/v3/workflows/{workflowId}エンドポイントを使用します。

注記

このAPIエンドポイントを使用できるのは管理者のみです。

ownerIdを変更するには、新しい所有者が現在の所有者と同じサブスクリプションにある必要があります。

パラメーター

  • workflowId (文字列): 必須です。更新するワークフローのIDを入力します。

  • updateWorkflowContract (本文): 必須です。更新するワークフロー情報を入力します。

    • name (文字列): 必須です。ワークフロー名を入力します。Server UIに表示するワークフローの名前です。

    • versionId (文字列): 必須です。バージョンIDを入力します。

    • makePublished (ブール型): オプションです。指定しない場合、それまでと同じ値が使用されます。makePublishedパラメーターは、Serverにプッシュするワークフローの新しいバージョンを公開バージョンとするか否かを制御するためのものです。ワークフローをServerにプッシュする際に値を「false」に設定することで、自分だけが実行することができるようになります。

    • ownerId (文字列): 必須です。所有者IDを入力します。

    • workerTag (文字列): 必須です。workerTagがない場合、代わりに""を使用します。

    • districtTags (文字列): 必須です。ディストリクトタグを入力します。ディストリクトを使用すると、共有されたパブリックワークフローをタグでグループ化し、ユーザーが簡単に見つけられるようにすることができます。詳細については、「ディストリクト」ヘルプページを参照してください。

    • comments (文字列): 必須です。コメントを入力します。

    • isPublic (ブール型): オプションです。指定しない場合、それまでと同じ値が使用されます。

    • isReadyForMigration (ブール型): オプションです。指定しない場合、それまでと同じ値が使用されます。

    • othersMayDownload (ブール型): オプションです。指定しない場合、それまでと同じ値が使用されます。パブリックワークフローに「false」を設定すると、ワークフローは使用できなくなります。

    • othersCanExecute (ブール型): オプションです。指定しない場合、それまでと同じ値が使用されます。パブリックワークフローに「false」を設定すると、ワークフローは使用できなくなります。

    • executionMode (文字列): オプションです。使用可能な値は「Safe」、「SemiSafe」、「Standard」です。実行モードの詳細については、「セーフモードおよび準セーフ実行モード: ブロックされるツール、イベント、データコネクタ」ヘルプページを参照してください。

    • hasPrivateDataExemption (ブール型): オプションです。プライベートデータを含むワークフローを実行できるように、適用除外を設定します。適用除外を許可する場合は「true」、適用除外を許可しない場合は「false」を選択します。指定しない場合、それまでと同じ値が使用されます。詳細については、管理者のワークフローオプションページを参照してください。

    • workflowCredentialType (文字列): オプションです。使用できる値は、「Default」(既定)、「Required」(必須)、「Specific」(指定)です。

    • credentialId (文字列): オプションです。このワークフローのcredentialIdを指定します。

  • updateWorkflowContractの値の例:

    {
      "name": "string",
      "versionId": "string",
      "makePublished": true,
      "ownerId": "string",
      "workerTag": "string",
      "districtTags": [
        "string"
      ],
      "comments": "string",
      "isPublic": true,
      "isReadyForMigration": true,
      "othersMayDownload": true,
      "othersCanExecute": true,
      "executionMode": "Safe",
      "hasPrivateDataExemption": true,
      "workflowCredentialType": "Default",
      "credentialId": "string"
    }
curl -X 'PUT' \
  'http://localhost/webapi/v3/workflows/66ebd18d6e52ae73b4951085' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Workflow_3_4",
  "versionId": "66ebd18d3d6200007e000d89",
  "makePublished": true,
  "ownerId": "66ebd0896e52ae73b4951072",
  "workerTag": "",
  "districtTags": [],
  "comments": "nothing",
  "isPublic": true,
  "isReadyForMigration": true,
  "othersMayDownload": true,
  "othersCanExecute": true,
  "executionMode": "Safe",
  "hasPrivateDataExemption": true,
  "workflowCredentialType": "Default",
  "credentialId": ""
}'
  • 200: OK

    {
      "id": "string",
      "sourceAppId": "string",
      "dateCreated": "2024-08-15T11:20:45.231Z",
      "runCount": 0,
      "versions": [
        {
          "versionId": "string",
          "versionNumber": 0,
          "dateCreated": "2024-08-15T11:20:45.231Z",
          "uploadSource": "Designer",
          "uploadDate": "2024-08-15T11:20:45.231Z",
          "packageWorkflowType": "App",
          "published": true,
          "comments": "string",
          "runDisabled": true,
          "executionMode": "Safe",
          "workflowCredentialType": "Default",
          "credentialId": "string",
          "hasPrivateDataExemption": true,
          "othersMayDownload": true,
          "othersCanViewHistory": true,
          "details": {
            "isAmp": true,
            "fileName": "string",
            "author": "string",
            "copyright": "string",
            "description": "string",
            "name": "string",
            "noOutputFilesMessage": "string",
            "outputMessage": "string",
            "url": "string",
            "urlText": "string"
          }
        }
      ],
      "name": "string",
      "ownerId": "string",
      "workerTag": "string",
      "districtTags": [
        "string"
      ],
      "comments": "string",
      "isPublic": true,
      "isReadyForMigration": true,
      "publishedVersionId": "string",
      "othersMayDownload": true,
      "othersCanViewHistory": true,
      "othersCanExecute": true,
      "executionMode": "Safe",
      "hasPrivateDataExemption": true
    }
  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

  • 404: NotFound (見つかりません)

ワークフローパッケージをダウンロードする

ワークフローパッケージをダウンロードするには、GET {baseURL}/v3/workflows/{workflowId}/packageエンドポイントを使用します。

パラメーター

  • workflowId (文字列): 必須です。パッケージをダウンロードするワークフローIDを入力します。

  • versionId (文字列): オプションです。ワークフローの特定のバージョンIDを入力します。バージョンを指定しない場合は、公開されたバージョンがダウンロードされます。

    注記

    versionIDが2桁の場合、サイズ制限に達し、「414 - URI Too Long」というエラーが表示される可能性があります。この場合、JSONのversionID文字列を解析して、最新バージョンのみにトリミングしてください。これにより、フィールドの長さが制御されます。

リクエストの例: cURL

curl -X GET --header 'Accept: application/octet-stream' --header 'Authorization: Bearer BearerTokenGoesHere' 'http://localhost/webapi/v3/workflows/635a4be7dc6e24bb8ff0/package'

応答の例

  • 200: YXZPファイルのダウンロードストリーム。

  • 400: バージョンIDが無効です

  • 401: Unauthorized (権限がありません)

  • 403: 認証されたユーザーがワークフローをダウンロードする権限を持っていないか、ワークフローに直接のダウンロードが許可されていません。

  • 404: NotFound (見つかりません)

ワークフローの質問情報を取得する

ワークフローまたは分析アプリの質問情報を取得するには、GET {baseURL}/v3/workflows/{workflowId}/questionsエンドポイントを使用します。

パラメーター

  • workflowId (文字列): 必須です。情報を取得するワークフローIDを入力します。

  • versionId (文字列): オプションです。ワークフローの特定のバージョンIDを入力します。バージョンを指定しない場合は、公開されたバージョンが使用されます。

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/questions' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

    [
      {
        "name": "string",
        "questionType": "string",
        "description": "string",
        "value": "string",
        "multiple": true,
        "items": [
          {
            "key": "string",
            "value": "string"
          }
        ]
      }
    ]
  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

  • 403: この認証されたユーザーにはワークフローまたは質問へのアクセス権がありません。

  • 404: NotFound (見つかりません)

特定のワークフローのジョブに関する情報を取得する

特定のワークフローのジョブに関する情報を取得するには、 GET {baseURL}/v3/workflows/{workflowId}/jobs エンドポイントを使用します。

注記

クエリのステータスはErrorであっても、ジョブがCompleted(完了)として返されることがあります。これは、実行中にエラーが発生したものの、ワークフローが実行されたことを示します。

パラメーター

  • workflowId (文字列): 必須です。情報を取得するワークフローIDを入力します。

  • sortField (文字列): オプションです。結果を並べ替えるためのフィールド名を入力します。

  • direction (文字列): オプションです。ここで並べ替え順を指定します。使用可能な値は「asc」(昇順)と「desc」(降順)です。並べ替えを指定しない場合、既定で昇順になります。

  • offset (文字列): オプションです。結果に表示する最初のレコードを指します。

  • limit (文字列): オプションです。結果に表示する最後のレコードを指します。

  • status (文字列): オプションです。ジョブの実行の全体的なステータスです。完了したジョブでも、失敗している可能性があります。使用可能な値は、「Complete」(完了)、「Error」(エラー)、「Running」(実行中)、「Queued」(順番待ち)です。

  • resultCode (文字列): オプションです。ワークフローの実行の結果コードです。これは、ワークフローは失敗したものの、ジョブは成功したことを示します。指定できる値は、「Success」(成功)、「Warning」(警告)、「Error」(エラー)です。

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/jobs' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

    [
      {
        "id": "string",
        "createDate": "2024-08-15T11:29:53.357Z",
        "status": "Created",
        "priority": "string",
        "workerTag": "string",
        "runWithE2": true
      }
    ]
  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

  • 404: NotFound (見つかりません)

ワークフローを削除する

特定のワークフローを削除するには、DELETE {baseURL}/v3/workflows/{workflowId} エンドポイントを使用します。

注記

このAPIエンドポイントを使用できるのは管理者のみです。

パラメーター

  • workflowId (文字列): 必須です。削除するワークフローIDを入力します。

  • force (ブール型): オプションです。選択しない場合は、既定値が「false」になります。ワークフローがスケジュールされている場合、パラメーターを「true」に設定すると、ワークフローを削除する前にすべてのスケジュールが削除されます。

curl -X 'DELETE' \
  'http://localhost/webapi/v3/workflows/670ce95bf10214f22a665bc4' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

  • 404: NotFound (見つかりません)

新しいジョブを作成する

新しいジョブを作成してジョブの実行キューに追加するには、POST /v3/workflows/{workflowId}/jobsエンドポイントを使用します。

パラメーター

  • workflowId (文字列): 必須です。スケジュールするワークフローIDを入力します。

  • contract (本文): 新しいジョブを作成するには、次のパラメーターを指定します。

    • workerTag (文字列): オプションです。割り当てられたワーカーを指定します。指定しない場合、値は「none」になります。

    • credentialId (文字列): オプションです。このワークフローのcredentialIdを指定します。

    • questions (文字列): オプションです。分析アプリの場合は、質問と回答を指定してワークフローを実行します。

      • name (文字列): オプションです。

      • value (文字列): オプションです。

    • priority (文字列): オプションです。実行するスケジュールの優先度を指定します。「Low」(低)、「Medium」(中)、「High」(高)、「Critical」(重大)のいずれかの値を選択します。指定しない場合、既定値は「Low」になります。

contractの値の例:

{
  "workerTag": "string",
  "credentialId": "string",
  "questions": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "priority": "Default"
}

ジョブを作成するリクエストの例:

curl -X 'POST' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/jobs' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workerTag": "",
  "credentialId": "",
  "priority": "Low"
}'
  • 200: OK

    {
      "id": "string",
      "appId": "string",
      "createDateTime": "2024-09-05T11:13:04.586Z",
      "status": "string",
      "disposition": "string",
      "outputs": [
        {
          "id": "string",
          "availableFormats": [
            "string"
          ],
          "fileName": "string"
        }
      ],
      "messages": [
        {
          "status": 0,
          "text": "string",
          "toolId": 0
        }
      ],
      "priority": "Default",
      "workerTag": "string",
      "runWithE2": true
    }
  • 400: BadRequest (不正な要求です)

  • 401: Unauthorized (権限がありません)

  • 403: この認証されたユーザーにはワークフローを実行するためのアクセス権がありません。

  • 404: NotFound (見つかりません)

指定した所有者にワークフローとスケジュールを移転する

特定のワークフローを(必要に応じてスケジュールと一緒に)特定の所有者に移転するには、PUT {baseURL}/v3/workflows/{workflowId}/transferエンドポイントを使用します。

注記

  • このAPIエンドポイントを使用できるのは管理者のみです。

  • DCM接続、Server接続、特定のRun As資格情報のいずれかをワークフローで実行する必要がある場合は、そのワークフローを実行する前にこれらの項目を更新する必要があります。

  • ユーザー全員が同じスタジオにいない場合にワークフローが新しいスタジオに移転すると、その新しい所有者のスタジオにいる他のすべてのユーザーもワークフローにアクセスできるようになりますが、古いスタジオのすべてのユーザーはアクセスできなくなります。

  • ワークフローは、クリエイターロールまたは管理者ロールを持つユーザーにのみ移転できます。

  • スケジュールを移転する場合、新しい所有者にはスケジュールされたワークフローへのアクセス権が必要です。そのアクセス権がなければ、そのワークフローを新しい所有者に移転できません。

  • スケジュールを移転する場合、新しい所有者にはワークフローをスケジュールする権限が必要です。

  • ユーザーが削除されると、移転後にキャンセルまたは無効になるスケジュールIDのリストが返されます。

パラメーター

  • workflowId (文字列): 必須です。移転するワークフローのIDを指定します。

  • contract (本文): 必須です。以下の情報を指定します。

    • ownerId (文字列): 必須です。新しい所有者のIDを指定します。

    • transferSchedules (ブール型): 必須です。スケジュールをワークフローと一緒に新しい所有者に移転するかどうかを指定します。現在のワークフロー所有者が所有するスケジュールのみが新しい所有者に移転されます。

contractの値の例:

{
  "ownerId": "string",
  "transferSchedules": true
}
curl -X 'PUT' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/transfer' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "ownerId": "670ceafbf10214f22a666c76",
  "transferSchedules": true
}'
  • 200: OK

  • 400: BadRequest (不正な要求です)

    "string"
  • 401: Unauthorized (権限がありません)

  • 403: Forbidden(禁止されています)

    "string"
  • 404: NotFound (見つかりません)

    "string"
  • 500: 内部サーバーエラー

オブジェクト関係

ワークフローをアップロードする場合、作成したオブジェクトを次のように使用することができます。

作成されたオブジェクト: "workflowId" (例えば、"id": "7917969784f84bd09442f66996ecb8f3")

次のように使用できます。

Postmanリクエストの例

GET /v3/workflows/{workflowId}

Use GET /v3/workflows/{workflowId} endpoint.

Postmanリクエストの詳細については、Postmanの使用方法ヘルプページを参照してください。