Method: projects.locations.instances.create

指定されたプロジェクトとロケーションで新しいインスタンスを作成します。

HTTP リクエスト

POST https://memorystore.googleapis.com/v1alpha/{parent=projects/*/locations/*}/instances

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。このインスタンスが作成される親リソース。形式: projects/{project}/locations/{location}

クエリ パラメータ

パラメータ
instanceId

string

必須。インスタンスに使用する ID。インスタンスのリソース名の最終的なコンポーネントになります。

この値には次の制限が適用されます。

  • 長さは 4～63 文字にしてください
  • 先頭は文字または数字でなければなりません
  • 使用できるのは小文字、数字、ハイフンのみです
  • 末尾にハイフンを付けることはできません
  • ロケーション内で一意にする必要があります。
requestId

string

省略可。リクエストを識別するリクエスト ID（省略可）。一意のリクエスト ID を指定することで、リクエストの再試行が必要なときに、リクエストが完了していれば、サーバーがリクエストを無視できるようになります。サーバーは、最初のリクエストから少なくとも 60 分間はこれを保証します。

たとえば、最初のリクエストを行い、そのリクエストがタイムアウトしたとします。同じリクエスト ID で再度リクエストを行うと、サーバーは元のオペレーションを同じリクエスト ID で受信していたかどうかを確認できます。受信していた場合は、2 回目のリクエストは無視されます。これにより、クライアントが重複するコミットを誤って作成することを防ぐことができます。

リクエスト ID は有効な UUID でなければなりません。ただし、ゼロ UUID（00000000-0000-0000-0000-000000000000）はサポートされていません。

リクエストの本文

リクエストの本文には Instance のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

IAM 権限

parent リソースに対する次の IAM 権限が必要です。

  • memorystore.instances.create

詳細については、IAM のドキュメントをご覧ください。