マネージインスタンスを照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 必須 DescribeManagedInstances

実行する操作です。 値をDescribeManagedInstancesに設定します。

RegionId String 必須 cn-hangzhou

管理対象インスタンスのリージョンID。 次のリージョンがサポートされています: 中国 (青島) 、中国 (北京) 、中国 (張家口) 、中国 (フフホト) 、中国 (杭州) 、中国 (上海) 、中国 (深セン) 、中国 (河源) 、中国 (香港) 。

すべてのDescribeRegions操作で、最新のリージョンリストを照会できます。

OsType String 任意 windows

管理対象インスタンスのオペレーティングシステムタイプ。 設定可能な値は以下のとおりです。

  • windows
  • linux
InstanceIp String 任意 192.168。**。** 。

管理対象インスタンスの内部IPアドレスまたはパブリックIPアドレス。

ActivationId String 任意 4ECEEE12-56F1-4FBC-9AB1-890F7494 ****

アクティベーションコードのID。

InstanceName String 任意 my-webapp-server

管理対象インスタンスの名前。

PageNumber Long 任意 1

返されるページ数。

ページ番号は 1 から始まります。

デフォルト値:1。

PageSize Long 任意 10

各ページで返されるエントリ数。

最大値: 50。

Default value: 10.

<td class="en-UStry align-left colsep-1 rowsep-1"> InstanceId.N </td> String 任意 mi-hz018jrc1o0 ****

管理対象インスタンスNのID。Nの有効値: 1 ~ 50。

レスポンスパラメーター

パラメーター データ型 説明
PageSize Long 10

1 ページあたりで返されるエントリ数。

RequestId String 77115469-F2C5-4ECA-94F7-FA04F2FD ****

リクエストの ID です。

PageNumber Long 1

返されたページの数です。

TotalCount Long 1

返されたマネージドインスタンスの総数。

インスタンス インスタンスの配列

管理対象インスタンスの詳細。

LastInvokedTime String 2021-01-20T09:00:40Z

Cloud Assistantタスクの最後の実行時間。

接続完了 Boolean true

マネージインスタンスが接続されているかどうかを示します。 設定可能な値は以下のとおりです。

  • true: 管理対象インスタンスは接続されており、Cloud Assistantを使用してインスタンスを管理できます。
  • false: マネージドインスタンスがダウンしているか、Cloud Assistantクライアントが正しくインストールされていないため、マネージドインスタンスが接続されていません。
InternetIp String 40.65。**。** 。

管理対象インスタンスのパブリックIPアドレス。

ホスト名 String demo

管理対象インスタンスのホスト名。

InstanceId String mi-hz018jrc1o0 ****

管理対象インスタンスのID。

ActivationId String 3704F543-F768-43FA-9864-897F75B3 ****

アクティベーションコードのID。

IntranetIp String 10.0。**。** 。

管理対象インスタンスの内部IPアドレス。

AgentVersion String 2.2.0.102

Cloud Assistantクライアントのバージョン番号。

RegistrationTime String 2021-01-20T08:57:56Z

マネージドインスタンスが登録された時刻。

InstanceName String webAPP-linux-01

管理対象インスタンスの名前。

OsType String Linux

管理対象インスタンスのオペレーティングシステムタイプ。

OsVersion String Linux_#38 ~ 18.04.1-Ubuntu SMP 1月6日水曜日18:26:30 UTC 2021_x86_64

オペレーティングシステムのバージョン情報。

InvocationCount Long 1

管理対象インスタンスでCloud Assistantタスクが実行された回数。

MachineId String e03231b37ab14e53b5795ad625fc ****

管理対象インスタンスのマシンコード。

リクエストの例

https://ecs.aliyuncs.com/?Action=DescribeManagedInstances
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeManagedInstancesResponse>
<インスタンス>
    <MachineId>e03231b37ab14e53b5795ad625fc ****</MachineId>
    <InstanceId>mi-hz018jrc1o0 ****</InstanceId>
    <AgentVersion>2.2.0.102</AgentVersion>
    <Connected>true</Connected>
    <InvocationCount>1</InvocationCount>
    <OsVersion>Linux_#38 ~ 18.04.1-Ubuntu SMP 1月6日水曜日18:26:30 UTC 2021_x86_64</OsVersion>
    <ActivationId>3704F543-F768-43FA-9864-897F75B3 ****</ActivationId>
    <ホスト名> デモ </ホスト名>
    <RegistrationTime>2021-01-20T08:57:56Z</RegistrationTime>
    <IntranetIp>10.0。**。</IntranetIp>
    <InstanceName>webAPP-linux-01</InstanceName>
    <InternetIp>40.65。**。</InternetIp>
    <OsType>Linux</OsType>
    <LastInvokedTime>2021-01-20T09:00:40Z</LastInvokedTime>
</インスタンス>
<TotalCount>1</TotalCount>
<RequestId>77115469-F2C5-4ECA-94F7-FA04F2FDC8F4</RequestId>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
</DescribeManagedInstancesResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "インスタンス" : [ {
    "MachineId" : "e03231b37ab14e53b5795ad625fc ****" 、
    "InstanceId" : "mi-hz018jrc1o0 ****" 、
    "AgentVersion" : "2.2.0.102" 、
    "Connected" : true、
    "InvocationCount" : 1、
    "OsVersion" : "Linux_#38 ~ 18.04.1-Ubuntu SMP 1月6日水曜日18:26:30 UTC 2021_x86_64" 、
    "ActivationId" : "3704F543-F768-43FA-9864-897F75B3 ****" 、
    "ホスト名" : "デモ" 、
    "RegistrationTime" : "2021-01-20T08:57:56Z" 、
    "IntranetIp" : "10.0。** 。
    "InstanceName" : "webAPP-linux-01" 、
    "InternetIp" : "40.65。** 。**" 、
    "OsType" : "Linux" 、
    "LastInvokedTime" : "2021-01-20T09:00:40Z"
  } ],
  "TotalCount" : 1、
  "RequestId" : "77115469-F2C5-4ECA-94F7-FA04F2FDC8F4" 、
  "PageSize" : 10,
  "PageNumber" : 1
}

エラーコード

HTTP状態コード エラーコード エラーメッセージ 説明
400 RegionId.ApiNotSupported このリージョンではapiはサポートされていません。 指定されたリージョンで操作を呼び出すことができない場合に返されるエラーメッセージ。 RegionIdパラメーターが有効かどうかを確認します。
400 InvalidParam.PageNumber 指定したパラメーターは無効です。 指定されたPageNumberパラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidParam.PageSize 指定したパラメーターは無効です。 指定されたPageSizeパラメーターが無効な場合に返されるエラーメッセージ。
403 操作禁止 操作は許可されていません。 操作がサポートされていない場合に返されるエラーメッセージ。
500 InternalError.Dispatch リクエストの送信時にエラーが発生しました。 リクエストの送信時にエラーが発生した場合に返されるエラーメッセージ。 しばらくしてから再試行します。

エラーコードリストについては、「API エラーセンター」をご参照ください。