Validar clave externa

$client->organization->externalKeys->validate(string externalKeyID): ExternalKeyValidateResponse

POST/v1/organizations/external_keys/{external_key_id}/validate

Valida una configuración de clave externa contra el KMS del cliente.

Anthropic realiza un ciclo de cifrado/descifrado con la clave de KMS configurada y espera hasta 30 segundos el resultado. El estado de la respuesta es success si el ciclo se completó correctamente, o failure con un mensaje de error si falló o se agotó el tiempo de espera.

Parameters

externalKeyID: string⁠Path

ID of the External Key.

Returns

class ExternalKeyValidateResponse { $type = 'external_key_validation'; $error; $status; }

"external_key_validation" type

?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.

Validar clave externa

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;

$client = new Client(apiKey: 'my-anthropic-api-key');

$response = $client->organization->externalKeys->validate('external_key_id');

var_dump($response);

Response 200

{
  "error": "error",
  "status": "failure",
  "type": "external_key_validation"
}

Returns Examples

Response 200

{
  "error": "error",
  "status": "failure",
  "type": "external_key_validation"
}