Create or Update Storage instance

puthttps://app.mk.io/api/v1/projects/:project_name/media/storage/:storage_name

Create or update a Storage instance. Only the description, credentials and privateLinkServiceConnection details are updatable.

RBAC Capability Required: infra.storage.create or infra.storage.update

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

storage_namestringRequired

Request

This endpoint expects an object.

Loading schema details…

Response

200Storage instance successfully updated

Loading schema details…

201Storage instance successfully created

Loading schema details…

Errors

400Bad Request

Loading schema details…

401Unauthorized

Loading schema details…

403Forbidden

Loading schema details…

404Not Found

Loading schema details…

429Too Many Requests

Loading schema details…

500Internal Server Error

Loading schema details…

put/api/v1/projects/{project_name}/media/storage/{storage_name}

curl -X PUT "https://app.mk.io/api/v1/projects/{project_name}/media/storage/{storage_name}" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "spec": {
    "bucketName": "my-aws-bucket",
    "credential": {
      "accessKeyId": "AKIAEXAMPLE123456789",
      "secretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    },
    "description": "Input media files for processing.",
    "type": "AWS.S3"
  }
}'

200Storage instance successfully updated

{
  "kind": "string",
  "metadata": {
    "created": "2024-01-01T00:00:00Z",
    "createdBy": "00000000-0000-0000-0000-000000000000",
    "createdByEmail": "string",
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "updated": "2024-01-01T00:00:00Z",
    "updatedBy": "00000000-0000-0000-0000-000000000000",
    "updatedByEmail": "string"
  },
  "spec": {
    "type": "Microsoft.Storage",
    "credential": {
      "sasToken": "?sv=2022-11-02&ss=bfqt&srt=co&sp=rwdlacupiyx&se=2024-11-12T00:05:04Z&st=2024-11-11T16:05:04Z&spr=https&sig=<redacted>",
      "signedExpiry": "2024-11-12T00:05:04Z",
      "signedStart": "2024-11-11T16:05:04Z"
    },
    "description": "Input media files for processing.",
    "privateLinkServiceConnection": {
      "requestMessage": "string",
      "resourceGroupName": "string",
      "storageAccountName": "string",
      "subscriptionId": "00000000-0000-0000-0000-000000000000"
    },
    "region": "string",
    "url": "https://blobsamples.blob.core.windows.net/"
  },
  "status": {
    "activeCredentialId": "00000000-0000-0000-0000-000000000000",
    "privateLinkServiceConnectionStatus": "Creating"
  }
}