統合の更新(アクティブ化/非アクティブ化)
post
/ic/api/integration/v1/integrations/{id}
統合をアクティブ化または非アクティブ化します。 アクティブな統合を変更するには、最初にその統合を非アクティブ化する必要があります。
- アクティブ化: 統合を作成し、ステータスがCONFIGUREDの場合、その統合をランタイム環境にアクティブ化できます。
統合をアクティブ化する場合、バージョン番号が重要になることに注意してください:
- XYZ/01.00.0000をアクティブ化し、XZY/01.00.0001をアクティブ化すると、XYZ/01.00.0001をアクティブ化する前にXYZ/01.00.0000が自動的に非アクティブ化されます。 この場合、アクティブ化された統合は1つのみです(XZY/01.00.0001)。 自動非アクティブ化は手動非アクティブ化と同様に動作します。
- 統合XYZ/01.00.0000が現在アクティブ化されている場合、XYZ/02.00.0000をアクティブ化すると、アクティブ化された2つの統合が作成されます。
- 非アクティブ化: 統合を非アクティブ化すると、新たなメッセージの処理を停止できます。 処理されていない保留中のリクエストがある場合、非アクティブ化の後で失われます。
リクエスト
サポートされているメディア・タイプ
- application/json; charset=utf-8
パス・パラメータ
- id(required): string
統合コンポジット識別子 IDは|(縦線)文字で区切られたコードおよびバージョンで構成されます。 フォーマット: code%7Cversion. 例: SC2RN%7C01.00.0000。 cURLを使用する場合には、縦線のかわりに%7Cを使用します。
問合せパラメータ
- deleteEventSubscriptionFlag: string
- enableAsyncActivationMode: string
非同期モードで統合をアクティブ化/非アクティブ化します。 cURLリクエストは、更新プロセスが完了し、バックグラウンドで更新が終了するまで待機しません。
- oracleRecommendsFlag: boolean
Oracle推奨フラグ
ヘッダー・パラメータ
統合リソース
ルート・スキーマ : integration
型:
ソースを表示
object- apipId: string
- bartaBuiltBy: string
- code: string
- compatible: boolean
デフォルト値:
false - created: string(date-time)
- createdBy: string
- dependencies: object IntegrationDependencyRs
- description: string
- docUrl: string
- endPoints: array endPoints
- endPointURI: string
- eventSubscriptionFlag: boolean
デフォルト値:
false - filmstrip: array filmstrip
- id: string
- isCloneAllowed: boolean
デフォルト値:
false - isViewAllowed: boolean
デフォルト値:
false - keywords: string
- lastUpdated: string(date-time)
- lastUpdatedBy: string
- links: array links
- lockedBy: string
- lockedDate: string(date-time)
- lockedFlag: boolean
デフォルト値:
false - mepType: string
- name: string
- originalIntegrationCode: string
- packageName: string
- pattern: string
- patternDescription: string
- payloadTracingEnabledFlag: boolean
デフォルト値:
false - percentageComplete: number
- projectModelVersion: string
- projectType: string
- properties: array properties
- proxyWSDL: string
- publishFlag: boolean
デフォルト値:
false - recordEnabledFlag: boolean
デフォルト値:
false - scheduleApplicableFlag: boolean
デフォルト値:
false - scheduleDefinedFlag: boolean
デフォルト値:
false - scheduleParams: object scheduleParams
許可される追加のプロパティ: additionalProperties
- securityPolicy: string
- smartTags: string
- status: string
- stopScheduleForDeactivation: boolean
デフォルト値:
false - style: string
- styleDescription: string
- submitNowURI: string
- totalEndPoints: integer(int32)
- tracingEnabledFlag: boolean
デフォルト値:
false - trackingInstanceName: string
- trackingVariables: array trackingVariables
- version: string
- warningMsg: string
ネストされたスキーマ : scheduleParams
型:
object使用可能なその他のプロパティ
ソースを表示
- object additionalProperties
許可される追加のプロパティ: additionalProperties
ネストされたスキーマ : TrackingVariableType
型:
ソースを表示
object- description: string
- id: string
- messageContextRef(required): object ReferenceType
- name(required): string
- output(required): object WirepointType
- primary: boolean
デフォルト値:
false - property: array property
- refUri: string
- role: string
- subRole: string
- type: string
許容値:
[ "ORCHESTRATION", "RECEIVE", "ROUTER", "ROUTER_ROUTE", "TRANSFORMER", "TRY", "TRY_CATCH", "INVOKE", "REPLY", "LABEL", "ASSIGNMENT", "FOR", "STOP", "SCHEDULERECEIVE", "STAGEFILE", "FAULTREPLY", "CALLOUT", "WHILE", "WAIT", "NOTE", "GLOBAL_VARIABLE", "GLOBAL_TRY", "GLOBAL_CATCH_ALL", "CATCH_ALL", "EHSTOP", "NOTIFICATION", "ACTIVITY_STREAM_LOGGER", "STITCH", "THROW", "PICK", "PICKRECEIVE", "TRACKING_VARIABLE", "REJECT", "INTEGRATION_METADATA", "INTEGRATION_PROPERTIES" ] - xpath(required): string
ネストされたスキーマ : WirepointType
型:
ソースを表示
object- messageContextRef: object ReferenceType
- name: string
- property: array property
- resourceGroup: array resourceGroup
- role: string
許容値:
[ "REQUEST", "RESPONSE", "FAULT", "VARIABLE" ] - subRole: string
ネストされたスキーマ: ResourceType
型:
ソースを表示
object- externalLocation: string
- location: string
- name: string
- property: array property
- resourceDescription: string
- resourceName: string
- role: string
- subRole: string
- type: string
許容値:
[ "XSD", "XSLT", "JCA", "WSDL", "WADL", "PROPERTIES", "UNDEFINED" ]
レスポンス
サポートされているメディア・タイプ
- application/json; charset=utf-8
200レスポンス
操作の成功
404レスポンス
統合が見つかりません
412レスポンス
すでにアクティブ化済/非アクティブ化済であるか、アクティブ化/非アクティブ化できません。
500レスポンス
サーバー・エラー
例
次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、統合をアクティブ化/非アクティブ化する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。 エンドポイントURLの構造の詳細は、「リクエストの送信」を参照してください。
例: 統合のアクティブ化/非アクティブ化
Request:
curl -X POST -H 'Authorization: Bearer access_token' -H "Content-Type:application/json" -H "X-HTTP-Method-Override:PATCH" -d @update.json https://integration.us.oraclecloud.com/ic/api/integration/v1/integrations/HELLO_WORLD%7C01.02.0000
リクエスト本文:
JSON形式のリクエスト本文のコンテンツの例を次に示します。 これは、cURLコマンドにリストされているupdate.jsonファイルの内容です。 JSONファイルには1つのメイン属性が含まれる必要があります: status。 この例では、統合がアクティブ化されます。 統合を非アクティブ化するには、ステータスをCONFIGUREDに設定します。
{"status":"ACTIVATED"}可能なステータスはアクティブな統合に対してステータスがACTIVATEDであるか、非アクティブな統合に対してCONFIGUREDです。
例: 非同期モードでの統合のアクティブ化/非アクティブ化
この例では、非同期モードで統合を非アクティブ化します。 cURLリクエストは、更新プロセスの完了を待機しません。 更新がバックグラウンドで終了している間、リクエストは成功で戻ります。
curl -X POST -H 'Authorization: Bearer access_token' -H "Content-Type:application/json" -H "X-HTTP-Method-Override:PATCH" -d @update.json -d 'enableAsyncActivationMode=true' https://integration.us.oraclecloud.com/ic/api/integration/v1/integrations/HELLO_WORLD%7C01.02.0000リクエスト本文:
{"status":"CONFIGURED"}統合スケジュールを停止して統合を非アクティブ化するには、リクエスト本文でstopScheduleForDeactivationを使用します:
{
"status":"CONFIGURED",
"stopScheduleForDeactivation":"true"
}