機械翻訳について

移動

• リクエスト
• レスポンス
• 例

インスタンス再起動リクエストの作成

post

/rebootinstancerequest/

インスタンスが実行開始後にハングした場合、このリクエストを使用してインスタンスを再起動できます。 このリクエストの作成後、リクエストのステータスを取得するには、GET /rebootinstancerequest/{name}を使用します。 rebootinstancerequestのステータスがcompleteに変わると、インスタンスが再起動されたことがわかります。

インスタンスを再起動するには名前を指定する必要があり、それはGET /instance/{container}/によって表示できます。

必要なロール: このタスクを実行するには、Compute_Operationsのロールが必要です。 このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

サポートされるメディア・タイプ

• application/oracle-compute-v3+json

ヘッダー・パラメータ

• Cookie: string
  Cookie:ヘッダーは、サービスに対するすべてのリクエストに含まれる必要があります。 それをPOST /authenticate/コールに対して受信されたレスポンス内のset-cookieヘッダーの値に設定してください。

本文 ()

リクエスト本文には、作成するインスタンス再起動リクエストの詳細が含まれます。

ルート・スキーマ : RebootInstanceRequest-post-request

型: object

リクエスト本文には、作成するインスタンス再起動リクエストの詳細が含まれます。

ソースの表示

• hard(optional): boolean
  インスタンスが実行開始後にハングした場合は、これをtrueに設定し、ハード・リセットを実行します。
• instance: string
  再起動するインスタンスのマルチパート名。

{
    "required":[
        "instance"
    ],
    "description":"The request body contains details of the reboot instance request that you want to create. ",
    "properties":{
        "hard":{
            "type":"boolean",
            "description":"If the instance hangs after it starts running, set this to <code>true</code> to perform a hard reset."
        },
        "instance":{
            "type":"string",
            "description":"Multipart name of the instance that you want to reboot."
        }
    }
}

トップに戻る

レスポンス

サポートされるメディア・タイプ

• application/oracle-compute-v3+json

201レスポンス

作成されました。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

ヘッダー

• set-cookie: string
  セッションが拡張された場合、Cookie値が返されます。

本文 ()

ルート・スキーマ : RebootInstanceRequest-response

型: object

ソースの表示

• creation_time(optional): string
  リクエスト作成のタイムスタンプ。
• error_reason(optional): string
  このリクエストがerror状態になった理由の説明。
• hard(optional): boolean
  ハード・リセットの実行
• instance(optional): string
  再起動するインスタンスのマルチパート名。
• name(optional): string
  サーバーによって生成された一意の識別子。
• state(optional): string
  リクエストの状態。
• uri(optional): string
  Uniform Resource Identifier

{
    "properties":{
        "creation_time":{
            "type":"string",
            "description":"Timestamp of request creation."
        },
        "error_reason":{
            "type":"string",
            "description":"A description of the reason this request entered <code>error</code> state."
        },
        "hard":{
            "type":"boolean",
            "description":"Perform a hard reset"
        },
        "instance":{
            "type":"string",
            "description":"Multipart name of the instance that you want to reboot."
        },
        "name":{
            "type":"string",
            "description":"Unique identifier generated by the server."
        },
        "state":{
            "type":"string",
            "description":"The state of the request."
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        }
    }
}

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、インスタンス再起動リクエストを作成する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。 この例では、読みやすくするために改行が使用されています。

curl -i -X POST
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Content-Type: application/oracle-compute-v3+json"
     -H "Accept: application/oracle-compute-v3+json"
     -d "@requestbody.json"
        https://api-z999.compute.us0.oraclecloud.com/rebootinstancerequest/

• COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。 認証クッキーの取得および変数への格納の詳細は、認証を参照してください。

• api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。 この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。 サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。

リクエスト本文の例

次の例では、インスタンス/Compute-acme/[e-mail]/7b036196-d077-4b6a-b2c8-64bc9d8d97ceのインスタンス再起動リクエストを作成するためのrequestbody.jsonファイルのリクエスト本文の内容を示しています。

{
 "hard": true,
 "instance": "/Compute-acme/[e-mail]/7b036196-d077-4b6a-b2c8-64bc9d8d97ce"
}

レスポンス本文の例

次の例は、レスポンス本文をJSON形式で示しています。

{
  "name": "/Compute-acme/[e-mail]/7b036196-d077-4b6a-b2c8-64bc9d8d97ce/8666a368-6264-4cee-9ec4-63996234deb1",
  "client_owned": true,
  "hard": true,
  "creation_time": "2016-05-10T16:08:10Z",
  "uri": "https://api-z999.compute.us0.oraclecloud.com/rebootinstancerequest/Compute-acme/[e-mail]/7b036196-d077-4b6a-b2c8-64bc9d8d97ce/8666a368-6264-4cee-9ec4-63996234deb1",
  "instance_id": "7b036196-d077-4b6a-b2c8-64bc9d8d97ce",
  "instance": "/Compute-acme/[e-mail]/7b036196-d077-4b6a-b2c8-64bc9d8d97ce",
  "state": "active",
  "request_id": "8666a368-6264-4cee-9ec4-63996234deb1",
  "error_reason": ""
}

トップに戻る