機械翻訳について

移動

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

SSHキーの追加

post

/sshkey/

Compute ClassicにSSH公開キーを追加します。

まず、ssh-keygenなどのツールを使用して必要なSSHキーペアを生成してから、公開キーをCompute Classicにアップロードする必要があります。 SSHキーペアを生成する方法については、「Oracle Cloud Infrastructure Compute Classicの使用」の「SSHキーペアの生成」を参照してください。

SSH公開キーを追加したら、「起動プランを使用したインスタンスの作成」で説明しているように、キーの名前を起動プランに指定することによって、それらをインスタンスと関連付けることができます。

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

リクエスト

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

• application/oracle-compute-v3+json

ヘッダー・パラメータ

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

本文 ()

リクエスト本文には、作成するSSHキーの詳細が含まれます。

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

型: object

リクエスト本文には、作成するSSHキーの詳細が含まれます。

ソースの表示

• enabled(optional): boolean

  キーを有効(デフォルト)または無効のいずれに設定するかを示します。 無効化されたキーはインスタンスと関連付けできない点に注意してください。

  キーを明示的に有効化するには、trueを指定します。 キーを無効化するには、falseを指定します。

• key: string

  SSH公開キーの値。

• name: string

  オブジェクトの、3つの部分からなる名前(/Compute-identity_domain/user/object)。

  オブジェクト名には、英数字、アンダースコア(_)およびハイフン(-)のみを含めることができます。 オブジェクト名は大文字と小文字が区別されます。

{
    "required":[
        "key",
        "name"
    ],
    "description":"The request body contains details of the SSH key that you want to create. ",
    "properties":{
        "enabled":{
            "type":"boolean",
            "description":"<p>Indicates whether the key must be enabled (default) or disabled. Note that disabled keys cannot be associated with instances.<p>To explicitly enable the key, specify <code>true</code>. To disable the key, specify <code>false</code>."
        },
        "key":{
            "type":"string",
            "description":"<p>The SSH public key value."
        },
        "name":{
            "type":"string",
            "description":"<p>The three-part name of the object (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>).<p>Object names can contain only alphanumeric characters, hyphens, underscores, and periods. Object names are case-sensitive."
        }
    }
}

トップに戻る

レスポンス

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

• application/oracle-compute-v3+json

201レスポンス

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

ヘッダー

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

本文 ()

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

型: object

ソースの表示

• enabled(optional): boolean
  キーが使用可能(true)であるか使用不可であるかを示します。
• key(optional): string

  SSH公開キーの値。

• name(optional): string

  オブジェクトの、3つの部分からなる名前

• uri(optional): string
  Uniform Resource Identifier

{
    "properties":{
        "enabled":{
            "type":"boolean",
            "description":"Indicates whether the key is enabled (<code>true</code>) or disabled."
        },
        "key":{
            "type":"string",
            "description":"<p>The SSH public key value."
        },
        "name":{
            "type":"string",
            "description":"<p>The three-part name of the object"
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        }
    }
}

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、SSHキーを追加する方法を示しています。 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/sshkey/

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

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

リクエスト本文の例

次は、requestbody.jsonファイルのリクエスト本文のコンテンツの例です。

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

{
 "enabled": false,
 "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDzU21CEj6JsqIMQAYwNbmZ5P2BVxA...",
 "name": "/Compute-acme/[e-mail]/key1"
}

レスポンス本文の例

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

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

{
 "enabled": false,
 "uri": "https://api-z999.compute.us0.oraclecloud.com/sshkey/Compute-acme/[e-mail]/key1",
 "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDzU21CEj6JsqIMQAYwNbmZ5P2BVxA...",
 "name": "/Compute-acme/[e-mail]/key1"
}

トップに戻る