Claude Platform Docs

驗證外部金鑰

ExternalKeyValidateResponse organization().externalKeys().validate(params = ExternalKeyValidateParams.none(), requestOptions = RequestOptions.none())
POST/v1/organizations/external_keys/{external_key_id}/validate

針對客戶的 KMS 驗證外部金鑰設定。

Anthropic 會對設定的 KMS 金鑰執行一次加密/解密往返，並最多等待 30 秒取得結果。若往返成功，回應狀態為 success；若失敗或逾時，則為 failure 並附帶錯誤訊息。

Parameters
ExternalKeyValidateParams params
Optional<String> externalKeyId⁠Path parameter

ID of the External Key.

maxLength2048
Returns
class ExternalKeyValidateResponse { type = "external_key_validation"; error; status; }

Result of a validation roundtrip against the customer's KMS.

HTTP 200 for both outcomes — the operation completed; status says whether the key works.

JsonValue type = "external_key_validation"
Optional<String> error

Error message when status is failure. Null otherwise.

Status status

success — encrypt/decrypt roundtrip succeeded. failure — the roundtrip failed or timed out; see error.

One of the following:
FAILURE("failure")
SUCCESS("success")
驗證外部金鑰
package com.anthropic.example;

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.organization.externalkeys.ExternalKeyValidateParams;
import com.anthropic.models.organization.externalkeys.ExternalKeyValidateResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        AnthropicClient client = AnthropicOkHttpClient.fromEnv();

        ExternalKeyValidateResponse response = client.organization().externalKeys().validate("external_key_id");
    }
}
Returns Examples
Response 200
{
  "error": "error",
  "status": "failure",
  "type": "external_key_validation"
}