POST/organization/external_storage/{external_storage_id}/validate

Validate an external storage configuration

Validates a customer-managed external storage configuration. Use external_storage_id to select the configuration whose provider setup you want to validate. The response returns the configuration and its status.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
external_storage_idstringrequired
The ID of the customer-managed external storage configuration to validate.

5 status codes
200Returns the external storage configuration, including its identifier, project, provider, geography, status, and creation time.
objectstringrequired
Allowed:organization.external_storageDefault:organization.external_storage
idstringrequired
project_idstringrequired
providerobjectrequired
geographystringrequired
statusstringrequired
Allowed:pendingvalidateddegradedunhealthy
created_atintegerrequired
400Returned when the configuration is invalid or the organization or project does not support it.
errorobjectrequired
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
404Returned when the organization, project, or external storage was not found.
errorobjectrequired
503Returned when external storage validation is temporarily unavailable.
errorobjectrequired

Error handling

A 400 is returned when the configuration is invalid or the organization or project does not support it. A 403 is returned when the authenticated user does not have permission to perform this operation; a 404 indicates that the organization, project, or external storage was not found. A 503 indicates that validation is temporarily unavailable. The external_storage_id path parameter must identify the configuration to validate.