Cisco UCS Director REST 開発者ガイド、リリース 5.0
API の操作
API の操作

API の操作

この章は、次の内容で構成されています。

REST API の操作の概要

この項に記載された Cisco UCS Director REST API 操作のカタログは、どの操作がニーズに対応するか、各操作をどのように行うかを知るために役立ちます。 レポート メタデータおよび REST API ブラウザを介した API 操作の要求と応答値の例が記載されています。


(注)  


POST メソッドを使用して実行される操作は、主に、サービスとプロビジョニングに使用されます。



(注)  


API 要求 URL の opData には、次の JSON パラメータ(操作に関連付けられた引数)が含まれます。
  • param0:REST API 経由で呼び出されるワークフローの名前。

  • param1:ワークフローに渡される入力。 複数の入力が存在する場合は、それらを引用符で囲んでから、カンマで区切って、中括弧内に入れます。 入力が存在しない場合は、API 呼び出しで null を使用します。

  • param2:このワークフローが他のサービス要求の子ワークフローとして呼び出される場合は、サービス要求 SR ID を使用します。 このワークフローが子ワークフローとして呼び出されない場合は、-1 を使用します。 -1 を使用した場合は、新しいサービス要求が呼び出されます。


ログインの操作

userAPIGetMyLoginProfile

説明

ログインしたユーザに関する情報を返します。

パラメータ

なし。

戻り値のタイプ

APILoginProfile

アクセス可能

管理者/エンド ユーザ

userAPIGetUserLoginProfile

説明

特定のユーザ ID に関するユーザ情報を返します。

パラメータ

String userId

戻り値のタイプ

APILoginReport

アクセス可能

管理者/エンド ユーザ


(注)  


ユーザ アカウントの操作も参照してください。ユーザの追加、オンボーディング、パスワードの管理、プロファイルなどの操作が説明されています。


ユーザ アカウントの操作

userAPIAddUser

説明

提供された情報(ユーザ ID、パスワード、電子メールなど)とともにユーザを追加します。

パラメータ
  • String userId

  • String password

  • String firstName

  • String lastName

  • String email

  • String role

  • String groupName

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者

userAPIOnBoarding

説明

APIUserOnBoardDetails 引数で提供された詳細を使用し、ユーザ、グループ、VDC を作成します。

パラメータ

APIUserOnBoardParams inParams

この JSON オブジェクトの例については、JSON オブジェクト パラメータ タイプを参照してください。

戻り値のタイプ

APIUserOnBoardDetails

この JSON オブジェクトの例については、JSON オブジェクト パラメータ タイプを参照してください。

アクセス可能

管理者/エンド ユーザ

userAPIGetUserLoginProfile

説明

特定のユーザ ID に関するユーザ情報を返します。

パラメータ

String userId

戻り値のタイプ

APILoginReport

アクセス可能

管理者/エンド ユーザ

userAPIDeleteUser

説明

特定のユーザ ID のユーザを削除します。

パラメータ

String userId

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者

userAPIResetMyPassword

説明

ユーザ アカウントのパスワードを、要求で提供された新しいパスワードにリセットします。

パラメータ

String newPassword

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ

userAPIResetUserPassword

説明

ユーザのパスワードを、提供されたユーザ ID と新しいパスワードにリセットします。

パラメータ
  • String user ID

  • String newPassword

  • boolean resetAPIKey


(注)  


restAPKey が true に設定されている場合には、パスワードのリセットだけでなく、REST API キーも Cisco UCS Director によってリセットされます。 false に設定されている場合には、その特定ユーザのパスワードのみがリセットされ、REST API キーは変更されません。 restAPKey が true に設定されている場合には、ユーザは何もする必要がありません。 パスワードのリセット時に REST API キーをリセットするか否かを決める必要があります。


戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者

userAPIVerifyUser

説明

提供されたパスワードでユーザを認証します。

パラメータ
  • String userId

  • String passWord

戻り値のタイプ

APILoginProfile

この JSON オブジェクトの例については、JSON オブジェクト パラメータ タイプを参照してください。

アクセス可能

管理者/エンド ユーザ


(注)  


ログインの操作も参照してください。


アカウントの操作

userAPICreateInfraAccount

説明

インフラ アカウントを作成します。

パラメータ
  • String accountName

  • String podName

  • int category

  • String accountType

  • String description

  • String contact

  • APIInfraAccount apiInfraAccount

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ

userAPIGetAllAccounts

説明

すべてのアカウントの名前を返します。

パラメータ
なし
戻り値のタイプ

List as String タイプ

アクセス可能

管理者/エンド ユーザ

userAPIGetAllPhysicalInfraAccounts

説明

すべての物理インフラ アカウント タイプを返します。

パラメータ
なし
戻り値のタイプ

List PhysicalInfraAccount

アクセス可能

管理者/エンド ユーザ

userAPIGetAccountTypeEntryByName

説明

特定のアカウント名のアカウント タイプ エントリを返します。

パラメータ
String Account name
戻り値のタイプ

List AccountTypeEntry

アクセス可能

管理者/エンド ユーザ

userAPIGetAccountTypeByName

説明

アカウント名に基づいてアカウント タイプを表示します。

パラメータ
String Account name
戻り値のタイプ

List as String

アクセス可能

管理者/エンド ユーザ

userAPIDeleteInfraAccount

説明

インフラ アカウントを削除します。

パラメータ
String Account name
戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ

レポートの操作

userAPIGetAvailableReports

説明

特定のコンテキストで利用可能なレポートを返します。

パラメータ
  • String contextName

  • String contextValue

戻り値のタイプ

List

アクセス可能

管理者/エンド ユーザ

userAPIGetTabularReports

説明

特定のコンテキストとレポート ID について表形式のレポートを返します。

パラメータ
  • String contextName

  • String contextValue

  • String reportId

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetHistoricalReport

説明

特定のコンテキスト、レポート ID、および期間について表形式のレポートを返します。

パラメータ
  • String contextName

  • String contextValue

  • String reportId

  • String durationName

戻り値のタイプ

APIHistoricalReport

アクセス可能

管理者/エンド ユーザ

userAPIGetInstantDataReport

説明

特定のコンテキストとレポート ID についてスナップショット レポートを返します。

パラメータ
  • String contextName

  • String contextValue

  • String reportId

戻り値のタイプ

APISnapshotReport

アクセス可能

管理者/エンド ユーザ

userAPIGetTabularReportWithMetaData

説明

メタデータを含むレポートを提供します。

パラメータ
  • String contextName

  • String contextValue

  • String reportId

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

承認の操作

userAPIGetMyApprovalList

説明

ログインしたユーザの承認リストを返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIUpdateMyApproval

説明

提供されたデータを使用し、現在のユーザの承認ステータスを更新します。

パラメータ
  • int requestId

  • int entryId

  • boolean isApproved

  • String comments

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ

カタログの操作

userAPICreateCatalogItem

説明

提供データで定義された特徴でカタログ項目を作成します。

パラメータ

APICatalogItem item

この JSON オブジェクトの例については、JSON オブジェクト パラメータ タイプを参照してください。

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者

userAPIGetAllCatalogs

説明

すべてのカタログ レポートを返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetCatalogsPerGroup

説明

特定のグループに割り当てられたカタログを返します。

パラメータ

String groupName

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetAllCatalogs

説明

すべてのカタログ レポートを返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

チャージバックの操作

userAPIChargebackDetails

説明

ログインしたユーザ グループに関するチャージバックの詳細を返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

資金の操作

userAPICheckFunds

説明

利用可能な顧客の資金を返します。

パラメータ

String userID

戻り値のタイプ

Double(利用可能な資金)

アクセス可能

管理者/エンド ユーザ


(注)  


支払いステータスの操作も参照してください。


グループの操作

userAPIAddGroup

説明

指定されたデータ(グループ名、説明、名前、電子メール)とともにグループを追加します。

パラメータ
  • String groupName

  • String description

  • String firstName

  • String lastName

  • String contactEmail

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者


(注)  


userAPIGetCatalogsPerGroup など多くの操作がグループ値に関連付けられています。 詳細については、主要操作のカテゴリを参照してください。


インベントリ(クラウド)の操作

userAPIRequestInventoryCollection

説明

指定されたクラウドのインベントリ収集をトリガーします。

パラメータ

String cloudName

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ

LOV プロバイダーの操作

userAPIgetStaticListByName

説明

リストの要素を返します。

パラメータ

リストの名前

戻り値のタイプ

FormLOVPair[]

アクセス可能

管理者/エンド ユーザ

userAPIgetBMAOSList

説明

Cisco UCS Director Baremetal Agent OS 名のリストを返します。

パラメータ

なし。

戻り値のタイプ

FormLOVPair[]

アクセス可能

管理者/エンド ユーザ

userAPIGetLOVProvidersList

説明

システム内の利用可能なリストの名前を返します。

パラメータ

なし。

戻り値のタイプ

List<String>

アクセス可能
管理者/エンド ユーザ

支払いステータスの操作

userAPIUpdatePaymentStatus

説明

金額およびタイムスタンプで支払いステータスを更新します。

パラメータ

APIMakePaymentParams inParams

この JSON オブジェクトの例については、JSON オブジェクト パラメータ タイプを参照してください。

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ


(注)  


資金の操作も参照してください。


リソース アカウンティングおよび制限

userAPIGetResourceAccounting

説明

ログインしたユーザ グループのリソース使用状況を返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetResourceAccountingDetails

説明

ログインしたユーザ グループのリソース使用状況の詳細を返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetResourceLimits

説明

要求されたグループに対するリソース制限を返します。

パラメータ

String groupName

戻り値のタイプ

APITabularReport

アクセス可能

管理者

userAPIGetResourceLimitsForMyGroup

説明

ログインしたグループのリソース制限を返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

サービス コンテナの操作

userAPICreateServiceContainerTemplate

説明

サービス コンテナ テンプレートを作成します。

パラメータ

パラメータの一覧については、JSON の例:APIServiceContainerTemplateを参照してください。

戻り値のタイプ

ブール値

アクセス可能

管理者/エンド ユーザ

userAPIUpdateServiceContainerTemplate

説明

サービス コンテナ テンプレートを更新します。

パラメータ

container Id:更新するサービス コンテナの ID。

戻り値のタイプ

ブール値

アクセス可能

管理者/エンド ユーザ

userAPIGetApplicationContainerTemplateDetails

説明

サービス コンテナを作成するために使用されるアプリケーション コンテナ テンプレートの詳細を返します。

パラメータ

applicationContainerTemplateName:アプリケーション コンテナに使用されるテンプレートの名前。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPICreateServiceContainer

説明

サービス コンテナを作成して、サービス要求 SR ID を整数値として返します。

パラメータ
  • groupName:ユーザが所属し、コンテナ プロビジョニング許可が許可されているグループの名前。

  • catalogName:アプリケーション コンテナ テンプレートを含むカタログの名前。

  • serviceContainerName:作成されるサービス コンテナの名前。

  • Comments:プロビジョニング操作に関するコメント。

戻り値のタイプ

整数

アクセス可能

管理者/エンド ユーザ

userAPICreateServiceContainerWithoutCatalog

説明

カタログを使用せずにサービス コンテナを作成して、サービス要求 SR ID を整数値として返します。

パラメータ
  • containerId:サービス コンテナの ID。

  • groupId:ユーザが属しており、コンテナ プロビジョニング権限が許可されているグループの ID。

  • applicationContainerTemplateName:サービス コンテナの作成に必要なコンテナ テンプレートの名前。

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIGetVNCURL

説明

VNC が起動して動作しているかどうかを確認するために使用される VNC URL を返します。

パラメータ

vmId:仮想マシンの ID。

戻り値のタイプ

String

アクセス可能

管理者/エンド ユーザ

userAPIGetAllServiceContainers

説明

すべてのサービス コンテナを返します。

パラメータ

なし

戻り値のタイプ

サービス コンテナのリスト

アクセス可能

管理者/エンド ユーザ

userAPIGetServiceContainerData

説明

サービス コンテナ データを返します。

パラメータ

Service container id:サービス コンテナの ID。

戻り値のタイプ

ContainerDataObjects

アクセス可能

管理者/エンド ユーザ

userAPIGetServiceContainerDetails

説明

ネットワーク サマリー、ポート マッピング、仮想マシン情報、イベント履歴などのサービス コンテナの詳細を返します。

パラメータ

container id:詳細を確認する必要があるサービス コンテナの ID。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetServiceContainerVirtualInfraPolicy

説明

インフラ ポリシーの詳細を返します。

パラメータ

infrapolicy name:詳細を確認する必要があるインフラ ポリシーの名前。

戻り値のタイプ

リスト

アクセス可能

管理者/エンド ユーザ

userAPIAddVMsServiceContainer

説明

サービス コンテナに仮想マシン(VM)を追加します。

パラメータ
  • containerId:仮想マシンを追加可能なサービス コンテナの ID。

  • ContainerVirtualMachine[ ]:サービス コンテナでプロビジョニングするコンテナ VM の配列。 VM パラメータを渡す必要があります。 Quantity と AppName が必須 VM パラメータです。ここで、AppName は VM 名です。

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIPowerOnServiceContainer

説明

サービス コンテナ内のすべての仮想マシン(VM)の電源を 1 つずつオンにします。

Cisco UCS Director は、次のように、VM の状態に基づいてサービス コンテナを異なる色で表示します。

  • なし:すべての VM の電源がオンになっています。

  • 青色:VM の電源をオンにしている最中。


    (注)  


    コンテナが長時間青色のままになっている場合は、サービス要求 ID をクリックして、VM プロビジョニング ステータスをチェックします。


  • 橙色:すべての非アクティブなインフラストラクチャ VM の電源がオンになっており、アクティブなアプリケーション VM が起動しています。

  • 黄色:すべてのアクティブなアプリケーション VM と非アクティブなアプリケーション VM の電源がオンになっています。

  • 緑色:すべてのインフラストラクチャ VM の電源がオンになっており、すべてのアプリケーション VM が起動しています。

  • 赤色:すべてのインフラストラクチャ VM(データベースなど)の電源がオフになっており、アクティブなアプリケーション VM(ゲートウェイ(GW)VM など)がダウンしています。

  • 灰色:すべてのインフラストラクチャ VM の電源がオフになっており、すべてのアプリケーション VM がダウンしています。

パラメータ

containerId:電源をオンにするサービス コンテナの ID。

戻り値のタイプ

ブール値

アクセス可能

管理者/エンド ユーザ

userAPIPowerOffServiceContainer

説明

サービス コンテナ内のすべての VM の電源をオフにします。 すべての VM の電源がオフになっており、GW VM がダウンしている場合は、コンテナが赤色で表示されます。

パラメータ

containerId:電源をオフにするサービス コンテナの ID。

戻り値のタイプ

Boolean

アクセス可能

管理者/エンド ユーザ

userAPIDeleteServiceContainer

説明

サービス コンテナを削除します。

パラメータ

containerId:削除するサービス コンテナの ID。

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPICloneServiceContainer

説明

ソース サービス コンテナに基づいて新しいサービス コンテナを作成します。

パラメータ
  • sourceContainerName:複製元にするサービス コンテナの名前。

  • destinationContainerName:新しいサービス コンテナの名前。

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

サービス要求操作

userAPISubmitServiceRequest

説明

VM プロビジョニングのサービス要求を送信します。 Qty 1 をサポートします。

パラメータ
  • String catalogName

  • String vdcName

  • int durationHours

  • int qty

  • String comments

  • beginTime

戻り値のタイプ

整数(サービス 要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIGetServiceRequests

説明

ユーザ グループのすべてのサービス リクエストを返します。

パラメータ

なし。

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetServiceRequestDetails

説明

サービス要求の詳細を返します。

パラメータ

int requestId

戻り値のタイプ

APIServiceRequestDetails

アクセス可能

管理者/エンド ユーザ

userAPICancelServiceRequest

説明

進行中のサービス要求をキャンセルします。

パラメータ

int requestID

戻り値のタイプ

ブール値

アクセス可能

管理者/エンド ユーザ

userAPIGetServiceRequestLogEntries

説明

要求された重大度のサービス要求のログ エントリを返します。

  • 0:デバッグ

  • 1:情報

  • 2:警告

  • 3:エラー

パラメータ
  • int srId

  • int severity(0 ~ 3)

戻り値のタイプ

ServiceRequestLogEntry[ ]

アクセス可能

管理者

userAPIGetServiceRequestLogEntriesAtLevels

説明

要求された重大度のサービス要求のログ エントリを返します。

  • 0:デバッグ

  • 1:情報

  • 2:警告

  • 3:エラー

パラメータ
  • int srId

  • String severityList(カンマ区切りの重大度値)

戻り値のタイプ

ServiceRequestLogEntry[]

アクセス可能

管理者

userAPIGetServiceRequestWorkFlow

説明

サービス要求ワークフローの詳細を返します。

パラメータ

int requestId

戻り値のタイプ

APIWorkFlowStatus

ワークフローの実行ステータスの値のセットは次のとおりです。

  • EXECUTION_STATUS_NOT_STARTED = 0

  • EXECUTION_STATUS_IN_PROGRESS = 1

  • EXECUTION_STATUS_FAILED = 2

  • EXECUTION_STATUS_COMPLETED = 3

  • EXECUTION_STATUS_COMPLETED_WITH_WARNING = 4

  • EXECUTION_STATUS_CANCELLED = 5

このレポートの例については、レポートおよび JSON オブジェクト応答サンプル を参照してください。

アクセス可能

管理者/エンド ユーザ

userAPISubmitVAppServiceRequest

説明

仮想アプリケーション カタログ タイプおよび引数とともにサービス要求を送信します。

パラメータ
  • String catalogName

  • APINameValueList list

戻り値のタイプ

int(サービス 要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIGetVMsForServiceRequest

説明

指定されたサービス要求に現在関連付けられている VM を返します。

パラメータ

int requestId

戻り値のタイプ

APIVMList

このレポートの例については、レポートおよび JSON オブジェクト応答サンプル を参照してください。

アクセス可能

管理者/エンド ユーザ

userAPISubmitWorkflowServiceRequest

説明

ワークフローとともにサービス要求を送信します。 サービス要求の ID を返します。

パラメータ
  • String workflowName

  • APINameValueList list

  • int parentSRID

戻り値のタイプ

int(サービス 要求 ID)

アクセス可能

管理者/エンド ユーザ


(注)  


userAPIGetServiceRequestWorkFlow などのサービス要求に関連した操作の詳細については、ワークフローの操作を参照してください。


タスクの操作

タスクのさまざまな API 操作に関する情報は REST API ブラウザで見つけることができます。 詳細については、REST API ブラウザの使用を参照してください。


(注)  


ワークフローの操作も参照してください。


VDC の操作

userAPIGetAllVDCs

説明

ログインしたユーザ グループのすべての vDC(仮想データ センター)を返します。 パラメータは必要ありません。

パラメータ

なし。

戻り値のタイプ

APITabularReport

このレポートの詳細については、表形式のレポートを参照してください。

アクセス可能

管理者/エンド ユーザ

userAPICreateVDC

説明

指定されたデータによって定義される vDC(仮想データ センター)を作成します。

パラメータ

APIVDCDetails

この JSON オブジェクトの例については、JSON オブジェクト パラメータ タイプを参照してください。

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者


(注)  


ユーザ アカウントの操作userAPIOnboarding および サービス要求操作userAPISubmitServiceRequest も参照してください。


userAPIExportVDC

説明

Cisco UCS Director から vDC をエクスポートします。

パラメータ

vdcName:エクスポートする vDC の名前。

戻り値のタイプ

String

アクセス可能

管理者/エンド ユーザ

userAPIImportVDC

説明

Cisco UCS Director に vDC をインポートします。

パラメータ

vdcName:インポートする vDC の名前。

戻り値のタイプ

VDC

アクセス可能

管理者/エンド ユーザ

VM の操作

UserAPIProvisionRequest

説明

仮想マシン(VM)をプロビジョニングします。

パラメータ
  • String catalogName

  • String vdcName

  • String userID

  • int durationHours

  • int beginTime

  • int quantity

  • int memoryMB

  • int diskGB

  • int cores

  • int estimatedCost

  • String comments

  • String additionalInfo

  • int chargeFrequency

戻り値のタイプ

int(サービス要求 ID)

アクセス可能

管理者

UserAPIProvisionRequestWithPortGroup

説明

VM をプロビジョニングして、ユーザが VM のプロビジョニング中にポート グループ名を選択できるようにします。

パラメータ
  • String catalogName

  • String vdcName

  • String userID

  • int durationHours

  • int beginTime

  • int quantity

  • int memoryMB

  • int diskGB

  • int cores

  • int estimatedCost

  • String comments

  • String additionalInfo

  • int chargeFrequency

  • String nicAliasName

  • String nicPortGroupName

戻り値のタイプ

int(サービス要求 ID)

アクセス可能

管理者

userAPIGetAllVMs

説明

ログインしたユーザのすべての VM を返します。 パラメータは必要ありません。

パラメータ
  • int vmId

  • int hostid

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetVMSummary

説明

指定された VM のサマリーを返します。

パラメータ

int vmId

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetVMsForServiceRequest

説明

指定されたサービス要求に現在関連付けられている VM を返します。

パラメータ

int requestId

戻り値のタイプ

APIVMList

レポートの例については、レポートおよび JSON オブジェクト応答サンプルを参照してください。

アクセス可能

管理者/エンド ユーザ

userAPIGetVMActionRequests

説明

特定コンテキストの VM アクション要求を返します。

パラメータ
  • String contextName

  • String contextValue

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ

userAPIGetAvailableVMActions

説明

特定の VM ID で利用可能な VM アクションを返します。

パラメータ

int vmId

戻り値のタイプ

List

アクセス可能

管理者/エンド ユーザ

userAPIExecuteVMAction(汎用 VM の場合)

説明

特定の汎用 VM で指定された電源管理オプション アクションを実行します。

パラメータ
  • int vmId

  • String actionName:actionName の値には次が含まれます。

    • discardSaveState

    • pause

    • powerOff

    • powerOn

    • reboot

    • rebuildServer

    • repairVM

    • reset

    • resume

    • saveState

    • shutdownGuest

    • standby

    • suspend

  • String comments

戻り値のタイプ

String(VM アクション要求 ID)。 要求のステータス取得に使用されます。

アクセス可能

管理者/エンド ユーザ

userAPIExecuteVMAction(VMware vSphere VM の場合)

説明

特定の VMware vSphere VM で指定された電源管理オプション アクションを実行します。

パラメータ
  • int vmId

  • String actionName:actionName の値には次が含まれます。
    • addVMvNICs

    • assignVMToVDC

    • configureVMVNC

    • convertVMToTemplate

    • createVMDisks

    • customVMStackView

    • deleteVMDisks

    • deleteVMvNICs

    • destroyVM

    • diskResize

    • enableVMRCConsole

    • migrateVM

    • moveVMToVdc

    • powerOff

    • powerOn

    • privateCloudVMClone

    • reboot

    • reconfigure

    • reset

    • resynchVM

    • saveVMAsTemplate

    • shutdownGuest

    • standby

    • suspend

    • testVMVNCConnection

    • vmMountISOImageAsCDROM

    • vmwareVMInventory

  • String comments

戻り値のタイプ

String(VM アクション要求 ID)。 要求のステータス取得に使用されます。

アクセス可能

管理者/エンド ユーザ

userAPIExecuteVMAction(Microsoft Hyper-V VM の場合)

説明

特定の Microsoft Hyper-V VM で指定された電源管理オプション アクションを実行します。

パラメータ
  • int vmId

  • String actionName:actionName の値には次が含まれます。
    • addHyperVvNics

    • customVMStackView

    • deleteHyperVvNic

    • destroyVM

    • discardSaveState

    • hypervAddVMDisk

    • hypervDiskResize

    • hypervMarkGoldenSnapshot

    • hyperVReconfigure

    • hypervRemoveVMDisk

    • hyperVRepair

    • hypervSnapshotCreate

    • hypervSnapshotDelete

    • hypervSnapshotDeleteAll

    • hypervSnapshotRevert

    • pause

    • powerOff

    • powerOn

    • reset

    • resume

    • saveState

    • shutdownGuest

    • vmwareVMInventory

  • String comments

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIReconfigureVM

説明

指定された VM をリサイズします。

パラメータ
  • int vmId

  • int memorySizeInMb

  • int numVCPUS:仮想マシン用仮想 CPU の数

  • String comments

戻り値のタイプ

String

アクセス可能

管理者/エンド ユーザ

userAPIGetVMActionStatus

説明

特定の VM アクション要求の VM アクション ステータスを返します。

パラメータ

String requestactionId

戻り値のタイプ

APIVMActionStatus

アクセス可能

管理者/エンド ユーザ

userAPISetVMProperties

説明

VM にユーザ ラベルを割り当てます。

パラメータ
  • int vmId

  • String userLabel

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ

userAPIGetVMAccessCredentials

説明

VM アクセス クレデンシャルを返します。

パラメータ

int vmId

戻り値のタイプ

APIVMAccess

アクセス可能

管理者/エンド ユーザ

userAPIGetVMSnapshotDetails

説明

VM スナップショットの詳細を返します。

パラメータ

int vmId

戻り値のタイプ

APITabularReport

アクセス可能

管理者/エンド ユーザ/エンド ユーザ

userAPICreateVMSnapshot

説明

提供されたパラメータに基づいてスナップショットを作成します。 スナップショットは VM 上の既存データのバックアップです。 後で VM に障害が発生した場合、エンド ユーザはスナップショットに復元することができます。

パラメータ
  • int vmId

  • String name

  • String descr

  • boolean isMemory:値を true に設定すると、メモリのスナップショットを作成

  • boolean isQuiesce:値を true に設定すると、ファイル システムを休止

戻り値のタイプ

String(VM アクション要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPICheckContextActionStatus

説明

VM アクションのステータス メッセージの詳細を返します。

パラメータ

statusId:VM アクションを実行するスレッドから更新されるデータベースからステータスをチェックするために使用される文字列の ID 値です。

戻り値のタイプ

String

API namespace

genericvm

アクセス可能

管理者/エンド ユーザ

userAPIDeleteCatalogItem

説明

VM をプロビジョニングするために作成されたカタログを削除します。

パラメータ

catalogItemName:削除する必要のあるカタログ項目の名前。

戻り値のタイプ

ブール値

アクセス可能

管理者/エンド ユーザ

userAPIVMWareProvisionRequest

説明

テンプレートを使用して VMware VM をプロビジョニングし、サービス要求 SR ID を整数値として返します。

パラメータ
  • String catalogName:カタログの名前。

  • String vdcName:VDC の名前。

  • String vmName:プロビジョニングする VM の名前。

  • String comment:VM ラベルに設定されるコメント。

  • double vCpus:CPU の数。

  • double memory:GB 単位のメモリのサイズ。

  • String datastores:VM ディスクの数。

  • String opNicPortGroup:VM ネットワーク。

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIVMWareCloneVMProvisionRequest

説明

VMware VM を複製して、サービス要求 SR ID を整数値として返します。

パラメータ
  • String vmID:複製する必要のある VM の ID。

  • String vdcName:VDC の名前。

  • String vmName:プロビジョニングする必要のある VM の名前。

  • boolean useLinkedClone:リンク付き複製機能を使用する場合は true に設定します。

  • String snapshotKey:新しいスナップショットを作成せずに使用する必要のある Snapshotkey。

  • String snapshotName:新しいスナップショットの名前。 このパラメータは、新しいスナップショットの作成に使用されます。

  • String comment:VM ラベルに設定されるコメント。

  • double vCpus:CPU の数。

  • double memory:GB 単位のメモリのサイズ。

  • String chargeFrequency:充電の頻度。 このパラメータは、Hourly または Monthly の値を受け入れます。

  • String datastores:VM ディスクの数。

  • String opNicPortGroup:VM ネットワーク。

  • String credentials:このパラメータは、"Do not share"、"Share after password reset"、または "Share template credentials" の値を受け入れます。

  • String userid

  • String password

  • boolean provisionDiskinSingleDatastore:単一のデータストアにすべてのディスクをプロビジョニングする場合は true に設定します。

  • String vmappChargeFrequency:vmapp 充電の頻度。 このパラメータは、Hourly または Monthly の値を受け入れます。

  • double activeVMCost

  • double inactiveVMCost

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ

userAPIVMWareMoveVMProvisionRequest

説明

VM を VDC に移動して、サービス要求 SR ID を整数値として返します。

パラメータ
  • String vmID:移動する必要のある VM の ID。

  • String vdcName:VDC の名前。

  • String credentials:このパラメータは、"Do not share"、"Share after password reset"、または "Share template credentials" の値を受け入れます。

  • String userid

  • String password

  • boolean provisionDiskinSingleDatastore:単一のデータストアにすべてのディスクをプロビジョニングする場合は true に設定します。

  • String vmappChargeFrequency:vmapp 充電の頻度。 このパラメータは、Hourly または Monthly の値を受け入れます。

  • double activeVMCost

  • double inactiveVMCost

  • String comment:VM ラベルに設定されるコメント。

  • double vCpus:CPU の数。

  • double memory:GB 単位のメモリのサイズ。

  • String datastores:VM ディスクの数。

  • String opNicPortGroup:VM ネットワーク。

戻り値のタイプ

整数(サービス要求 ID)

アクセス可能

管理者/エンド ユーザ


(注)  


オプション入力を設定する場合は、空の文字列を渡します。 sample をダミー文字列として渡さないでください。


ワークフローの操作

userAPIGetWorkflows

説明

フォルダ内のワークフローを返します。

パラメータ

String folderName

戻り値のタイプ

CustomActionDefinition[ ]

アクセス可能

管理者

userAPIGetWorkflowStatus

説明

ワークフローの実行ステータス コードを返します。

パラメータ

int srId

戻り値のタイプ

int

ワークフローの実行ステータスの値のセットは次のとおりです。

  • EXECUTION_STATUS_NOT_STARTED = 0

  • EXECUTION_STATUS_IN_PROGRESS = 1

  • EXECUTION_STATUS_FAILED = 2

  • EXECUTION_STATUS_COMPLETED = 3

  • EXECUTION_STATUS_COMPLETED_WITH_WARNING = 4

  • EXECUTION_STATUS_CANCELLED = 5

  • EXECUTION_STATUS_PAUSED = 6

  • EXECUTION_STATUS_SKIPPED = 7

アクセス可能

管理者

userAPIGetWorkflowInputs

説明

ワークフローの入力を返します。

パラメータ

String workflowName

戻り値のタイプ

APINameValueList

アクセス可能

管理者

userAPIValidateWorkFlow

説明

ワークフローを検証し、結果を返します。

パラメータ

String workflowName

戻り値のタイプ

APIWFValidationResult

アクセス可能

管理者

userAPISubmitWorkflowServiceRequest

説明

ワークフローとともにサービス要求を送信します。 サービス要求の ID を返します。

パラメータ
  • String workflowName

  • APINameValueList list

  • int parentSRID

戻り値のタイプ

int(サービス リクエスト ID)

アクセス可能

管理者/エンド ユーザ

userAPIRollbackWorkflow

説明

指定されたサービス要求 ID をロールバックします。

パラメータ

int srId

戻り値のタイプ

int(サービス要求 ID)

アクセス可能

管理者

userAPIExportWorkflows

説明

指定されたワークフローをエクスポートします。

パラメータ

String workflowNames

戻り値のタイプ

APICustomWorkflowDefinitionList

アクセス可能

管理者/エンド ユーザ

userAPIImportWorkflows

説明

システムにワークフローをインポートします。

パラメータ

APIWFExport export

戻り値のタイプ

ブール値(成功の場合 true)

アクセス可能

管理者/エンド ユーザ