Method: projects.locations.attachedClusters.delete

特定の AttachedCluster リソースを削除します。

成功すると、レスポンスには新しく作成された Operation リソースが含まれます。このリソースを記述して、オペレーションのステータスを追跡できます。

HTTP リクエスト

DELETE https://{endpoint}/v1/{name=projects/*/locations/*/attachedClusters/*}

ここで、{endpoint}サポートされているサービス エンドポイントのいずれかです。

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

パスパラメータ

パラメータ
name

string

必須。削除する AttachedCluster のリソース名。

AttachedCluster 名の形式は projects/<project-id>/locations/<region>/attachedClusters/<cluster-id> です。

Google Cloud Platform リソース名について詳しくは、リソース名をご覧ください。

クエリ パラメータ

パラメータ
validateOnly

boolean

設定されている場合はリクエストの検証のみが行われます。リソースは削除されません。

allowMissing

boolean

true に設定されて AttachedCluster リソースが見つからない場合、リクエストは成功しますが、サーバーでアクションは実行されず、完了した Operation が返されます。

べき等削除に便利です。

ignoreErrors

boolean

true に設定すると、クラスタ リソースの削除中にエラーが発生しても、AttachedCluster リソースの削除は成功します。このパラメータを使用すると、クラスタ内に孤立したリソースが発生する可能性があります。

etag

string

AttachedCluster の現在の etag。

クライアントがオプティミスティック同時実行制御で削除を行えるようにします。

指定された ETag がクラスタの現在の ETag と一致しない場合、リクエストは失敗し、ABORTED エラーが返されます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

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

認可スコープ

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

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

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

IAM 権限

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

  • gkemulticloud.attachedClusters.delete

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