Method: projects.locations.privateClouds.hcxActivationKeys.create

指定されたプライベート クラウドに新しい HCX アクティベーション キーを作成します。

HTTP リクエスト

POST https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*/privateClouds/*}/hcxActivationKeys

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

パスパラメータ

パラメータ
parent

string

必須。鍵を作成するプライベート クラウドのリソース名。リソース名は、https://cloud.google.com/apis/design/resource_names の規則に従ったスキームレス URI です。例: projects/my-project/locations/us-central1/privateClouds/my-cloud

認可には、指定されたリソース parent に対する次の IAM の権限が必要です。

  • vmwareengine.hcxActivationKeys.create

クエリ パラメータ

パラメータ
hcxActivationKeyId

string

必須。作成する HcxActivationKey のユーザー指定 ID。この識別子は、親内の HcxActivationKey リソース間で一意である必要があり、名前 URI の最後のトークンになります。識別子は次の要件を満たす必要があります。

  • 1 ～ 63 個の英数字とハイフンのみを使用している
  • 先頭が英字である
  • ハイフン以外の文字で終わる
  • UUID の形式になっていない
  • RFC 1034（セクション 3.5）に準拠
requestId

string

リクエストを識別するリクエスト ID。一意のリクエスト ID を指定することで、リクエストの再試行が必要なときに、リクエストが完了していれば、サーバーがリクエストを無視できるようになります。サーバーは、リクエストによって重複するコミットメントが少なくとも 60 分間作成されないことを保証します。

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

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

詳細については、Authentication Overview をご覧ください。