マネージインスタンスを照会します。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | DescribeManagedInstances |
実行する操作です。 値をDescribeManagedInstancesに設定します。 |
RegionId | String | 必須 | cn-hangzhou |
管理対象インスタンスのリージョンID。 次のリージョンがサポートされています: 中国 (青島) 、中国 (北京) 、中国 (張家口) 、中国 (フフホト) 、中国 (杭州) 、中国 (上海) 、中国 (深セン) 、中国 (河源) 、中国 (香港) 。 すべてのDescribeRegions操作で、最新のリージョンリストを照会できます。 |
OsType | String | 任意 | windows |
管理対象インスタンスのオペレーティングシステムタイプ。 設定可能な値は以下のとおりです。
|
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 |
マネージインスタンスが接続されているかどうかを示します。 設定可能な値は以下のとおりです。
|
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 エラーセンター」をご参照ください。