← Cloudflare R2 / r2 / api

Коды ошибок

Эта страница описывает коды ошибок, возвращаемые R2 при использовании API Workers или S3-совместимый API, а также рекомендуемые исправления для устранения неполадок.

Для API Workers, операции R2 выбрасывают исключения, которые можно перехватить. Код ошибки указывается в конце message свойство:

try {
  await env.MY_BUCKET.put("my-key", data, { customMetadata: largeMetadata });
} catch (error) {
  console.error(error.message);
  // "put: Your metadata headers exceed the maximum allowed metadata size. (10012)"
}

Для S3-совместимый API, ошибки возвращаются в виде XML в теле ответа:

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchKey</Code>
  <Message>The specified key does not exist.</Message>
</Error>