機械翻訳について

移動

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

すべてのシェイプに関する詳細の取得

get

/shape/

使用可能なすべてのシェイプのCPUおよびメモリーの詳細を取得します。

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

リクエスト

この操作のリクエスト・パラメータはありません。

トップに戻る

レスポンス

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

• application/oracle-compute-v3+json

200レスポンス

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

ヘッダー

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

本文 ()

ルート・スキーマ : Shape-list-response

型: object

ソースの表示

• result(optional): array result

{
    "properties":{
        "result":{
            "items":{
                "$ref":"#/definitions/Shape-response"
            },
            "type":"array"
        }
    }
}

ネストされたスキーマ : result

型: array

ソースの表示

• Array of: object Shape-response

{
    "items":{
        "$ref":"#/definitions/Shape-response"
    },
    "type":"array"
}

ネストされたスキーマ : Shape-response

型: object

ソースの表示

• cpus(optional): number
  このシェイプのインスタンスに割り当てられているCPUまたは部分CPUの数。
• gpus(optional): integer
  このシェイプのインスタンスに割り当てられているgpuデバイスの数。
• io(optional): integer
  このシェイプのインスタンスに割り当てられているIO共有。
• is_root_ssd(optional): boolean
  SSDストレージのルート・ディスク・イメージを格納します。
• name(optional): string
  このシェイプの名前。
• nds_iops_limit(optional): integer
  NDSストレージ・ボリュームのIOのレートを制限します。
• placement_requirements(optional): array placement_requirements
  配置場所に一致するノードに任意のタグを指定する文字列のリスト。
• ram(optional): integer
  このシェイプのインスタンスに割り当てられているメモリーのメガバイト数。
• root_disk_size(optional): integer
  ルート・ディスクのサイズ(バイト)。
• ssd_data_size(optional): integer
  ローカルSSDデータ・ディスクのサイズ(バイト)。
• uri(optional): string
  Uniform Resource Identifier

{
    "properties":{
        "cpus":{
            "type":"number",
            "description":"Number of CPUs or partial CPUs allocated to instances of this shape."
        },
        "gpus":{
            "type":"integer",
            "description":"Number of gpu devices allocated to instances of this shape"
        },
        "io":{
            "type":"integer",
            "description":"IO share allocated to instances of this shape."
        },
        "is_root_ssd":{
            "type":"boolean",
            "description":"Store the root disk image on SSD storage."
        },
        "name":{
            "type":"string",
            "description":"Name of this shape."
        },
        "nds_iops_limit":{
            "type":"integer",
            "description":"Limits the rate of IO for NDS storage volumes."
        },
        "placement_requirements":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"A list of strings specifying arbitrary tags on nodes to be matched on placement."
        },
        "ram":{
            "type":"integer",
            "description":"Number of megabytes of memory allocated to instances of this shape."
        },
        "root_disk_size":{
            "type":"integer",
            "description":"Size of the root disk in bytes."
        },
        "ssd_data_size":{
            "type":"integer",
            "description":"Size of the local SSD data disk in bytes."
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        }
    }
}

ネストされたスキーマ : placement_requirements

型: array

配置場所に一致するノードに任意のタグを指定する文字列のリスト。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"A list of strings specifying arbitrary tags on nodes to be matched on placement."
}

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、すべてのシェイプの詳細を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

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

curl -X GET 
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Accept: application/oracle-compute-v3+json"
     https://api-z999.compute.us0.oraclecloud.com/shape/

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

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

レスポンス本文の例

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

{
  "result": [
    {
      "nds_iops_limit": 0,
      "ram": 122880,
      "cpus": 16.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc4m",
      "io": 800,
      "name": "oc4m"
    },
    {
      "nds_iops_limit": 0,
      "ram": 122880,
      "cpus": 32.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc7",
      "io": 1000,
      "name": "oc7"
    },
    {
      "nds_iops_limit": 0,
      "ram": 61440,
      "cpus": 8.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc3m",
      "io": 600,
      "name": "oc3m"
    },
    {
      "nds_iops_limit": 0,
      "ram": 245760,
      "cpus": 32.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc5m",
      "io": 1000,
      "name": "oc5m"
    },
    {
      "nds_iops_limit": 0,
      "ram": 7680,
      "cpus": 2.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc3",
      "io": 200,
      "name": "oc3"
    },
    {
      "nds_iops_limit": 0,
      "ram": 30720,
      "cpus": 8.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc5",
      "io": 600,
      "name": "oc5"
    },
    {
      "nds_iops_limit": 0,
      "ram": 15360,
      "cpus": 4.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc4",
      "io": 400,
      "name": "oc4"
    },
    {
      "nds_iops_limit": 0,
      "ram": 15360,
      "cpus": 2.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc1m",
      "io": 200,
      "name": "oc1m"
    },
    {
      "nds_iops_limit": 0,
      "ram": 30720,
      "cpus": 4.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc2m",
      "io": 400,
      "name": "oc2m"
    },
    {
      "nds_iops_limit": 0,
      "ram": 61440,
      "cpus": 16.0,
      "root_disk_size": 0,
      "uri": "https://api-z999.compute.us0.oraclecloud.com/shape/oc6",
      "io": 800,
      "name": "oc6"
    }
  ]
}

トップに戻る